curl --request GET \
--url https://api.gigstack.io/v2/invoices/errors \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.gigstack.io/v2/invoices/errors', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.gigstack.io/v2/invoices/errors"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"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": 1767225600000
}List CFDI 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
codeparameter - Search across all fields using
qparameter - Filter by error type (invoice, receiver, sender, unknown)
- Paginate results with
limitandpageparameters
curl --request GET \
--url https://api.gigstack.io/v2/invoices/errors \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.gigstack.io/v2/invoices/errors', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.gigstack.io/v2/invoices/errors"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"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": 1767225600000
}Authorizations
Authentication Method: HTTP Bearer token.
The runtime requires the literal Bearer prefix — a bare token in the
Authorization header is rejected with 401 unauthorized.
Header Format: Authorization: Bearer YOUR_API_KEY
Your API key is a JWT. Live keys operate on live data (livemode: true);
test keys operate on isolated test data (livemode: false).
Get your key at: app.gigstack.pro/settings?tab=api
Errors: credential failures are answered by the authentication layer with a raw
{ "message": … } body, not the standardized envelope — 401 for a missing, malformed or
expired token, 403 for a revoked key or a plan without API access. See the Unauthorized
and AuthForbidden responses.
Query Parameters
gigstack Connect: Target team ID for multi-team access.
Requires gigstack Connect enabled on your team and shared billing account.
Also requires the multipleIssuerAccounts feature on your plan. Requests targeting a
team other than the one your API key belongs to return 403 without it.
Only API keys can use it: an OAuth access token sent with another team's id is rejected with
403 Team mismatch with OAuth token.
Optional — omit it entirely unless you are acting on another team. It deliberately
carries no example value so generated snippets do not emit ?team=undefined; when the
parameter is absent, the team is derived from your API key.
Example: ?team=team_xyz789
Filter by exact error code (e.g., CFDI140223). Returns single document if found.
Search query. Searches across code, description, explanation, and solution fields.
Filter by error type
invoice, receiver, sender, unknown Number of results per page (max 100)
1 <= x <= 100Page number for pagination
x >= 1Response
CFDI errors retrieved successfully
true
Show child attributes
Show child attributes
Total count of matching errors
150
Current page number
1
Items per page
50
"CFDI errors retrieved successfully"
Unix timestamp in milliseconds
1734605400000