/organizations/{organizationId}/ in the URL. The invoice’s uuid (its folio fiscal) is enough to resolve the owning organization server-side, combined with the caller’s own auth context (session or API key).
The response is XML only.
Authentication
Accepts either:- A Supabase Bearer session (
Authorization: Bearer <token>) — the authenticated user must be a member of the invoice’s organization. - An API key (
X-API-Key: sk_test_...) with theread:invoicesscope — the key’s own organization must match the invoice’s organization, and the key’s environment (sandbox or production) must match the invoice’s, or the request is rejected with403 Forbidden.
Path Parameters
Example Request
cURL
TypeScript SDK
CLI
Example Response
This endpoint does not return a JSON body — it streams the raw XML file with:
The body is the decoded acuse XML (Timbrix stores it as the PAC returned it and decodes it for download). Abbreviated example (abreviado):
Timbrix stores the receipt the SAT returned when it received the cancellation
request and does not replace it when the request is later marked accepted: the
receiver’s response produces no new receipt in Timbrix. If the SAT answered
202 (the CFDI was previously cancelled), the receipt may correspond to the
earlier cancellation. To follow the status of a request, use List Invoice
Cancellations.
Common Errors
401 Unauthorized
Missing or invalid Bearer token / API key.403 Forbidden
The authenticated user is not a member of the invoice’s organization, or the API key does not have theread:invoices scope / belongs to a different organization than the one that owns the invoice. An API key whose environment differs from the invoice’s is rejected with the code ENVIRONMENT_MISMATCH.
404 Not Found
uuid does not match any invoice.
409 Conflict
Audit Log
Each successful download is recorded in the audit log ascfdi.cancellation_receipt_downloaded.