Skip to main content
GET
/
api
/
invoices
/
{id}
Get Invoice
curl --request GET \
  --url https://api.example.com/api/invoices/{id}
{
  "id": "<string>",
  "profile_id": "<string>",
  "uuid": "<string>",
  "fecha": "<string>",
  "mes": 123,
  "año": 123,
  "total": 123,
  "subtotal": 123,
  "iva": 123,
  "iva_amount": 123,
  "retencion_iva_amount": 123,
  "retencion_isr_amount": 123,
  "tipo": {},
  "rfc_emisor": "<string>",
  "nombre_emisor": "<string>",
  "regimen_fiscal_emisor": "<string>",
  "rfc_receptor": "<string>",
  "nombre_receptor": "<string>",
  "regimen_fiscal_receptor": "<string>",
  "concepto": "<string>",
  "pagos": [
    {
      "fechaPago": "<string>",
      "formaPago": "<string>",
      "monedaPago": "<string>",
      "monto": 123,
      "numOperacion": "<string>"
    }
  ],
  "complemento_pago": {
    "fechaPago": "<string>",
    "formaPago": "<string>",
    "monedaPago": "<string>",
    "tipoCambio": 123,
    "monto": 123,
    "numOperacion": "<string>",
    "facturasRelacionadas": [
      {
        "uuid": "<string>",
        "monedaDR": "<string>",
        "tipoCambioDR": 123,
        "metodoPagoDR": "<string>",
        "numParcialidad": 123,
        "impSaldoAnt": 123,
        "impPagado": 123,
        "impSaldoInsoluto": 123
      }
    ]
  },
  "validacion": {
    "rfcVerificado": true,
    "regimenFiscalVerificado": true,
    "uuidDuplicado": true,
    "advertencias": [
      "<string>"
    ],
    "errores": [
      "<string>"
    ],
    "valido": true
  },
  "estadoPago": {
    "estado": {},
    "totalFactura": 123,
    "totalPagado": 123,
    "saldoPendiente": 123,
    "porcentajePagado": 123,
    "completamentePagado": true,
    "ultimoSaldoInsoluto": 123,
    "tieneComplementos": true,
    "tienePagosManuales": true
  },
  "profile": {
    "id": "<string>",
    "nombre": "<string>",
    "rfc": "<string>"
  },
  "created_at": "<string>",
  "updated_at": "<string>"
}

​
Authentication

This endpoint requires authentication. Include your access token in the Authorization header. 
Authorization: Bearer YOUR_ACCESS_TOKEN

​
Path Parameters

​
id
string
required
The unique identifier of the invoice to retrieve

​
Response

​
id
string
Unique identifier for the invoice
​
profile_id
string
Profile ID this invoice belongs to
​
uuid
string
CFDI UUID (Folio Fiscal)
​
fecha
string
Invoice date in ISO format
​
mes
number
Month extracted from invoice date (1-12)
​
año
number
Year extracted from invoice date
​
total
number
Total amount of the invoice
​
subtotal
number
Subtotal before taxes
​
iva
number
IVA percentage rate
​
iva_amount
number
IVA transferred amount (impuesto trasladado)
​
retencion_iva_amount
number
IVA withholding amount
​
retencion_isr_amount
number
ISR withholding amount
​
tipo
enum
Payment type: PUE (payment in one exhibit), PPD (payment in installments), or COMPLEMENTO_PAGO (payment complement)
​
rfc_emisor
string
RFC of the issuer
​
nombre_emisor
string
Name of the issuer
​
regimen_fiscal_emisor
string
Tax regime code of the issuer
​
rfc_receptor
string
RFC of the recipient
​
nombre_receptor
string
Name of the recipient
​
regimen_fiscal_receptor
string
Tax regime code of the recipient
​
concepto
string
Invoice concept or description
​
pagos
array
Array of payment records
​
complemento_pago
object
Payment complement information (for COMPLEMENTO_PAGO type)
​
validacion
object
Validation results
​
estadoPago
object
Payment status details
​
profile
object
Profile information
​
created_at
string
Creation timestamp in ISO format
​
updated_at
string
Last update timestamp in ISO format

​
Example Request

curl -X GET "https://api.contafy.com/api/invoices/inv_abc123" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Example Response

{
  "id": "inv_abc123",
  "profile_id": "prof_123",
  "uuid": "12345678-90AB-CDEF-1234-567890ABCDEF",
  "fecha": "2026-03-15T10:30:00Z",
  "mes": 3,
  "año": 2026,
  "total": 11600.00,
  "subtotal": 10000.00,
  "iva": 16,
  "iva_amount": 1600.00,
  "tipo": "PUE",
  "rfc_emisor": "XAXX010101000",
  "nombre_emisor": "Empresa Ejemplo SA de CV",
  "regimen_fiscal_emisor": "601",
  "rfc_receptor": "BAXX010101000",
  "nombre_receptor": "Cliente Ejemplo",
  "regimen_fiscal_receptor": "612",
  "concepto": "Servicios de consultoría",
  "pagos": [],
  "complemento_pago": null,
  "validacion": {
    "rfcVerificado": true,
    "regimenFiscalVerificado": true,
    "uuidDuplicado": false,
    "advertencias": [],
    "errores": [],
    "valido": true
  },
  "estadoPago": {
    "estado": "PAGADO",
    "totalFactura": 11600.00,
    "totalPagado": 11600.00,
    "saldoPendiente": 0,
    "porcentajePagado": 100,
    "completamentePagado": true,
    "ultimoSaldoInsoluto": null,
    "tieneComplementos": false,
    "tienePagosManuales": false
  },
  "profile": {
    "id": "prof_123",
    "nombre": "Mi Empresa",
    "rfc": "BAXX010101000"
  },
  "created_at": "2026-03-15T10:35:00Z",
  "updated_at": "2026-03-15T10:35:00Z"
}

​
Error Responses

​
401 Unauthorized
{
  "error": "Unauthorized",
  "message": "Invalid or missing access token"
}
​
404 Not Found
{
  "error": "Not Found",
  "message": "Invoice not found"
}
​
403 Forbidden
{
  "error": "Forbidden",
  "message": "You do not have permission to access this invoice"
}
​
500 Internal Server Error
{
  "error": "Internal Server Error",
  "message": "An unexpected error occurred"
}