Skip to main content
GET
/
api
/
timbre
/
invoice
curl -X GET "https://app.usatimbre.com/api/timbre/invoice?org_id=org_123456&invoice_id=inv_abc123" \
  -H "Authorization: Bearer tmb_your_api_key_here"

{
  "id": "inv_abc123",
  "status": "completed",
  "amount": 1740.00,
  "subtotal": 1500.00,
  "tax": 240.00,
  "currency": "MXN",
  "vendor": {
    "name": "Restaurant XYZ S.A. de C.V.",
    "rfc": "RXY123456ABC",
    "address": "Av. Reforma 123, CDMX"
  },
  "cfdi_usage": "G03",
  "uuid": "6B8F9D3A-1234-5678-90AB-CDEF12345678",
  "created_at": "2024-01-20T15:30:00Z",
  "completed_at": "2024-01-20T15:35:00Z",
  "pdf_url": "https://app.usatimbre.com/invoices/inv_abc123.pdf",
  "xml_url": "https://app.usatimbre.com/invoices/inv_abc123.xml",
  "receipt_image_url": "https://app.usatimbre.com/receipts/inv_abc123.jpg"
}

​
Overview

Retrieve detailed information about a specific invoice, including download URLs for the PDF and XML (CFDI) files.

​
Query Parameters

​
org_id
string
required
The unique identifier of the organization
​
invoice_id
string
required
The unique identifier of the invoice

​
Response

​
id
string
Unique invoice identifier
​
status
string
Invoice status. Values: pending, processing, completed, failed
​
amount
number
Invoice total amount
​
subtotal
number
Invoice subtotal (before taxes)
​
tax
number
Tax amount (IVA)
​
currency
string
Currency code (e.g., MXN)
​
vendor
object
Vendor information
​
cfdi_usage
string
CFDI usage code used
​
uuid
string
SAT UUID (Folio Fiscal) - unique identifier assigned by SAT
​
created_at
string
ISO 8601 timestamp of creation
​
completed_at
string
ISO 8601 timestamp of completion (null if not completed)
​
pdf_url
string
URL to download the invoice PDF
​
xml_url
string
URL to download the invoice XML (CFDI)
​
receipt_image_url
string
URL of the original receipt image
curl -X GET "https://app.usatimbre.com/api/timbre/invoice?org_id=org_123456&invoice_id=inv_abc123" \
  -H "Authorization: Bearer tmb_your_api_key_here"

{
  "id": "inv_abc123",
  "status": "completed",
  "amount": 1740.00,
  "subtotal": 1500.00,
  "tax": 240.00,
  "currency": "MXN",
  "vendor": {
    "name": "Restaurant XYZ S.A. de C.V.",
    "rfc": "RXY123456ABC",
    "address": "Av. Reforma 123, CDMX"
  },
  "cfdi_usage": "G03",
  "uuid": "6B8F9D3A-1234-5678-90AB-CDEF12345678",
  "created_at": "2024-01-20T15:30:00Z",
  "completed_at": "2024-01-20T15:35:00Z",
  "pdf_url": "https://app.usatimbre.com/invoices/inv_abc123.pdf",
  "xml_url": "https://app.usatimbre.com/invoices/inv_abc123.xml",
  "receipt_image_url": "https://app.usatimbre.com/receipts/inv_abc123.jpg"
}

​
Invoice Status

StatusDescription
pendingInvoice request received, waiting to be processed
processingReceipt is being analyzed and invoice is being generated
completedInvoice generated successfully, PDF and XML available
failedInvoice generation failed (check error details)
For processing status, poll this endpoint every few seconds until the status changes to completed or failed.