---
title: "List CFDI errors"
method: GET
path: "/invoices/errors"
tags: ["Invoices"]
---

# List CFDI errors

`GET /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

## Query parameters

- `code` string
- `q` string
- `type` 'invoice' | 'receiver' | 'sender' | 'unknown'
- `limit` integer
- `page` integer

## Response `200`

CFDI errors retrieved successfully

- object
  - `success` boolean, required
  - `data` CfdiError[], required
    - `code` string, required — Unique CFDI error code identifier
    - `description` string, required — Brief description of the error (typically in Spanish as provided by SAT)
    - `explanation` string, required — Detailed explanation of why this error occurs
    - `solution` string, required — Actionable steps to resolve the error
    - `type` 'invoice' | 'receiver' | 'sender' | 'unknown', required — Category of the error
  - `total` integer, required — Total count of matching errors
  - `page` integer, required — Current page number
  - `limit` integer, required — Items per page
  - `message` string, required
  - `timestamp` number, required — Unix timestamp in milliseconds

## Other responses

- `404` — Error code not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/disruptive-learning/apis/gigstack-api-v2.md) · [All operations](https://skmtc.net/disruptive-learning/apis/gigstack-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/disruptive-learning/gigstack-api-v2/versions/5cf53ffd7580/schema)