Skip to main content
GET
List tax invoices

Authorizations

Authorization
string
header
required

Organization API key using Authorization: Bearer sk_....

Query Parameters

filter
string

A qs-encoded taxInvoiceFilter object.

Example:

"status=VALID&createdAt[gte]=2025-01-01T00:00:00.000Z"

skip
number
default:0

Pagination offset.

Required range: x >= 0
Example:

0

take
number
default:20

Pagination limit.

Required range: 1 <= x <= 100
Example:

20

orderBy
string

A qs-encoded taxInvoiceOrderBy object.

Example:

"createdAt=desc"

Response

Tax invoices list

id
string
required

Unique identifier of the tax invoice.

Example:

"txi_1234567890abcdefghij"

createdAt
required

When the tax invoice was created.

updatedAt
required

When the tax invoice was last updated.

status
enum<string>
required

Current tax invoice status.

Available options:
VALID,
CANCELED,
PENDING,
DRAFT,
PENDING_CANCELLATION,
FAILED
Example:

"VALID"

customerId
string
required

Customer identifier.

Example:

"cus_1234567890abcdefghij"

type
enum<string>
required

Quentli tax invoice type.

Available options:
TAX_RECEIPT,
TAX_INVOICE_PPD,
TAX_INVOICE_PUE
Example:

"TAX_INVOICE_PUE"

currency
string
required

ISO 4217 currency code.

Example:

"MXN"

totalAmount
number
required

Tax invoice total amount in minor units.

Example:

150000

organizationId
string
required

Owning organization identifier.

Example:

"org_1234567890abcdefghij"

issueDate

Date when the tax invoice was issued.

Example:

null

invoiceId
string | null

Related invoice identifier, if any.

Example:

null

paymentId
string | null

Related payment identifier, if any.

Example:

null

uuid
string | null

SAT UUID assigned to the tax invoice.

Example:

null

verificationUrl
string | null

SAT verification URL.

Example:

null

folio
string | null

Tax invoice folio.

Example:

null

failureReason
enum<string> | null

Normalized issuance failure reason, if any.

Available options:
UNKNOWN,
RFC_DOMICILE_MISMATCH,
RFC_LEGAL_NAME_MISMATCH,
CFDI_USAGE_MISMATCH,
ISSUE_DATE_OUT_OF_RANGE,
null
Example:

null

cancellationStatus
string | null

SAT cancellation status.

Example:

"none"

cancellationMotive
string | null

SAT cancellation motive code.

Example:

null

cancelRequestedAt

Date and time when cancellation was requested.

Example:

null

canceledAt

Date and time when cancellation completed.

Example:

null

canceledById
string | null

User that requested cancellation.

Example:

null

cancellationSubstitution
string | null

Substitution UUID used for cancellation motive 01.

Example:

null

satType
string | null

SAT invoice type code.

Example:

"I"

paymentForm
string | null

SAT payment form.

Example:

"03"

paymentMethod
string | null

SAT payment method.

Example:

"PUE"

usage
string | null

CFDI usage code.

Example:

"G03"

exchangeRate
number | null

Exchange rate used for non-MXN invoices.

Example:

null

pdfId
string | null

PDF file identifier, if available.

Example:

null

xmlId
string | null

XML file identifier, if available.

Example:

null

createdByUserId
string | null

User who created this tax invoice.

Example:

null

createdByCustomerId
string | null

Customer who created this tax invoice.

Example:

null

substituteTaxInvoiceId
string | null

Tax invoice that substituted this one, if any.

Example:

null