Invoices represent CFDI documents issued or received by an entity. Invoice records include SAT identifiers, issuer and receiver data, monetary totals, payment status, cancellation status, invoice relationships, file availability, and tags.Use the entity invoice list when you need all invoices extracted for one entity. Retrieve an invoice by ID when you need the full invoice resource, including tags and related invoice metadata. Use the CFDI endpoint when you need the XML or PDF content for a specific invoice.### Blacklist statusThe field `issuer.blacklistStatus` or `receiver.blacklistStatus` is set when the invoice issuer or receiverRFC is found in the [SAT 69-B list](https://omawww.sat.gob.mx/cifras_sat/Paginas/datos/vinculo.html?page=ListCompleta69B.html):| Status | Description ||-------------|-----------------------------------------------------------------------------------------------------------|| presumed | SAT has identified possible irregularities and started an investigation || dismissed | SAT dismissed the investigation after reviewing evidence || definitive | SAT determined that the RFC has confirmed irregularities || favorable | SAT reversed a definitive status after reviewing additional evidence |
Syntage DS MX SAT Invoices API is one of 65 APIs that Syntage publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include DS MX SAT Invoices. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and a getting-started guide.
This API exposes
8 operations
across 8 paths,
and defines 62 schemas.
It is described by OpenAPI 3.2.0, at version 2020-06-28.
Requests are made against 2 base URLs: https://api.syntage.com, https://api.sandbox.syntage.com.
8 operations8 paths62 schemas1 DELETE4 GET3 POST
Metadata
The identity and technical contract details declared by the specification.
Syntage DS MX SAT Invoices API declares
1 security scheme
for authenticating requests.
An API key is passed in the header as X-API-Key (ApiKey).
By default, every request must be authenticated.
ApiKey — Your API key is available in the [Production](https://app.syntage.com/settings/api-keys) and [Sandbox](https://app.sandbox.syntage.com/settings/api-keys) dashb…
Paths & Operations 8
Across 8 paths, the API surfaces 8 operations — 1 DELETE, 4 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.
DS MX SAT Invoices 8
Invoices represent CFDI documents issued or received by an entity. Invoice records include SAT identifiers, issuer and receiver data, monetary totals, payment status, cancellation…
GET
/invoices/{id}
Retrieve an invoice
GetInvoice1 param→ 200401404
POST
/invoices/{id}/tags
Tag an invoice
TagInvoice1 parambody→ 200401
DELETE
/invoices/{invoiceId}/tags/{tagId}
Untag an invoice
UntagInvoice2 params→ 204401
POST
/invoices/batch/tags
Tag multiple invoices
TagInvoicesBatchbody→ 201401404422
POST
/invoices/batch/tags/remove
Untag multiple invoices
UntagInvoicesBatchbody→ 201401404422
GET
/invoices/{id}/cfdi
Retrieve an invoice's CFDI
GetInvoiceCFDI2 params→ 200401404
GET
/datasources/mx/sat/cfdis/{uuid}
Retrieve a SAT CFDI
GetMxSatCfdi2 params→ 200202401404
GET
/entities/{entityId}/invoices
List an entity's invoices
ListTaxpayerInvoice89 params→ 200401404
Schemas 62
The contract defines 62 schemas that model the data the API accepts and returns. The most detailed are InvoiceCollectionItem (42 properties), InvoiceRelation (9 properties), Tag (8 properties), CursorCollection (6 properties). Each schema is shown below with its type and property counts.
InvoiceIssuedAt
string
Invoice issue date
InvoiceCurrency
stringnull
ISO 4217 alphabetic currency code
InvoiceRelationID
string
Invoice relation ID
InvoicePac
string
Certification provider tax ID (Proveedor Autorizado de Certificación)
InvoiceLastPaymentDate
stringnull
This field is populated with the last related payment date (Applies only for "PPD" invoices).
InvoiceRelationType
number
Invoice relation type code from the [cTipoRelacion](/guides/catalogsctiporelacion) catalog
TaxpayerName
string
Taxpayer name
InvoiceRelationRelatedInvoice
stringnull
Invoice IRI reference
InvoiceCollection
InvoiceCertifiedAt
string
Invoice certification date
InvoicePaymentTermsRaw
stringnull
The invoice payment terms text exactly as it comes from the invoice, i.e. immediate, 30 days, cash, credit card, etc
CollectionLimit
integer
InvoiceCreditedAmount
numbernull
Credited amount
Invoice
object
1 property
InvoiceTotal
number
Invoice total amount
InvoiceRelationRelatedInvoiceUuid
string
The related Invoice UUID (Folio fiscal)
InvoicePaymentTerms
stringnull
Payment terms
InvoiceIsIssuer
boolean
true if the invoice issuer is the entity's RFC
TagCollection
array
updatedAt
string
Date and time the resource was last updated
InvoiceIsReceiver
boolean
true if the invoice receiver is the entity's RFC
CollectionOrder
string
InvoicePaymentMethod
stringnull
Payment method code from the [cFormaPago](/guides/catalogscformapago) catalog
InvoiceStatus
string
Whether the invoice is active or canceled
InvoiceSubtotal
number
Subtotal amount
InvoicePaidAmount
number
For a deferred invoice this field state the paid amount. (Applies only for "PPD" invoices).
InvoiceUsage
stringnull
Invoice usage code from the [cUsoCFDI](/guides/catalogscusocfdi) catalog
InvoiceRelation
object
9 properties
InvoiceIssuerTaxRegime
numbernull
Tax regime code from the [cRegimenFiscal](/guides/catalogscregimenfiscal) catalog
InvoiceFullyPaidAt
stringnull
This field is populated when the total debt is paid. (Applies only for "PPD" invoices).
InvoiceID
string
Invoice ID
TagInvoicesBatchInput
object
2 properties2 required
MxSatCfdi
object
4 properties
InvoiceCancellationStatus
string
Whether or not the invoice can be canceled
InvoiceIssuer
object
4 properties
InvoiceSubtotalCreditedAmount
numbernull
Subtotal credited amount
TagInvoiceInput
object
1 property
InvoiceDiscount
number
Discount amount
createdAt
string
Date and time the resource was created
InvoiceCollectionItem
object
42 properties
InvoiceReceiver
object
3 properties
InvoiceDueAmount
number
For a deferred invoice this field state the due amount. (Applies only for "PPD" invoices).
InvoiceVersion
numbernull
CFDI version
InvoiceReference
stringnull
An open field for internal identification. Commonly used to identify a branch
uuid
string
InvoiceHasPDF
boolean
true when the CFDI is available in the PDF format. The file can be downloaded through the [retrieve an invoice CFDI](operation/GetInvoiceCFDI) operation
TaxpayerID
string
RFC (Registro Federal de Contribuyentes)
InvoiceTax
number
Tax amount
InvoicePaymentType
stringnull
Payment type code from the [cMetodoPago](/guides/catalogscmetodopago) catalog
Tag
object
8 properties
InvoiceCancellationStatusProcess
stringnull
Set when the cancellation process starts
InvoiceHasXML
boolean
true when the CFDI is available in the XML format. The file can be downloaded through the [retrieve an invoice CFDI](operation/GetInvoiceCFDI) operation
InvoiceExchangeRate
numbernull
Set when currency is different than MXN (Mexican Peso).
InvoiceInternalIdentifier
stringnull
An open field for internal identification. Commonly used to identify an invoice
InvoiceRelationInvoice
string
Invoice IRI reference
TaxpayerBlacklistStatus
stringnull
Show the blacklist status if a taxpayer is found in the list 69-B from SAT
CursorCollection
object
6 properties
InvoiceUUID
string
Invoice UUID (Folio fiscal)
InvoiceType
string
Invoice type code from the [cTipoDeComprobante](/guides/catalogsctipodecomprobante) catalog
InvoiceCanceledAt
stringnull
Set when status is CANCELADO
TagInvoicesBatch
object
2 properties
InvoicePlaceOfIssue
string
Postal code of the place of issue
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Syntage DS MX SAT Invoices API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
