GET /v1/invoices/{id}

Lee una factura ya emitida.

Solicitud

curl https://integration.contadito.com/v1/invoices/8801 \
  -H "Authorization: Bearer $CONTADITO_API_KEY"

Parámetro	Ubicación	Tipo	Notas
id	ruta	number	El id que devolvió POST /v1/invoices. No es el invoiceNumber.

aviso

id ≠ invoiceNumber

id es el identificador interno de la factura en Contadito; invoiceNumber es el correlativo del rango CAI. Este endpoint usa el id.

Respuesta 200

Idéntica en forma a la de POST /v1/invoices. replayed siempre viene false en una lectura, y pdfBase64 siempre viene null: para el PDF usa GET /v1/invoices/{id}/pdf.

{
  "id": 8801,
  "invoiceNumber": 1573,
  "cai": "A1B2C3-D4E5F6-A1B2C3-D4E5F6-A1B2C3-12",
  "invoiceDate": "2026-08-10T15:04:05.000Z",
  "clientId": 1042,
  "importe": 2000,
  "discountTotal": 0,
  "exemptedAmount": 0,
  "exoneratedAmount": 0,
  "totalTaxes": 300,
  "total": 2300,
  "totalInLetters": "DOS MIL TRESCIENTOS LEMPIRAS EXACTOS",
  "isPaid": true,
  "isAnnulled": false,
  "taxBreakdown": [{ "rate": 15, "taxAmount": 300, "taxedAmount": 2000 }],
  "lines": [
    {
      "externalProductId": "SKU-WEB-HOSTING-01",
      "quantity": 2,
      "unitPrice": 1000,
      "importe": 2000,
      "discountAmount": 0,
      "subTotal": 2000,
      "exemptAmount": null
    }
  ],
  "replayed": false,
  "pdfBase64": null
}

Alcance de la consulta

La consulta está limitada a la empresa de tu API key. Cualquier id fuera de ese alcance responde 404 EXTERNAL_INVOICE_NOT_FOUND, el mismo error que un id inexistente.

Errores

HTTP	code	Causa
400	—	El id de la ruta no es un entero.
401	MISSING_API_KEY / INVALID_API_KEY	Credencial.
404	EXTERNAL_INVOICE_NOT_FOUND	No existe dentro de tu empresa.

Para qué usarlo

• Conciliación: verificar que la factura quedó como esperabas.
• Reimpresión: recuperar cai, invoiceNumber y totalInLetters — o el documento completo con GET /v1/invoices/{id}/pdf.
• Auditoría de anulaciones: consultar isAnnulled (las anulaciones se hacen desde la app de Contadito, no por API).

En v1 no hay listado ni búsqueda de facturas: solo lectura por id. Guarda el id cuando emitas.