List CFDI errors

GET

https://api.gigstack.io/v2/invoices/errors

Retrieve a paginated and filterable list of CFDI errors from the error matrix.
Use this endpoint to search for error codes, understand error causes, and find solutions.

Query Options:

Filter by exact error code using code parameter

Search across all fields using q parameter

Filter by error type (invoice, receiver, sender, unknown)

Paginate results with limit and page parameters

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Query Params

Responses

🟢200OK

application/json

CFDI errors retrieved successfully

Body

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.gigstack.io/v2/invoices/errors?code=CFDI140223&q=RFC&type=receiver&limit=50&page=1'

Response Example

200 - Single error by code

{
    "success": true,
    "data": [
        {
            "code": "CFDI140223",
            "description": "El campo Rfc del receptor no es valido",
            "explanation": "The RFC (tax ID) provided for the receiver does not meet the validation requirements or format specified by SAT",
            "solution": "Verify that the receiver's RFC is correct, properly formatted (13 characters for individuals, 12 for legal entities), and matches SAT's registered information",
            "type": "receiver"
        }
    ],
    "total": 1,
    "page": 1,
    "limit": 1,
    "message": "CFDI error retrieved successfully",
    "timestamp": "2025-12-19T10:30:00.000Z"
}

Modified at 2026-01-23 18:33:49

Create egress invoice

List payment complement invoices