Skip to main content
GET
https://sandbox.cucu.bo
/
api
/
v1
/
invoices
/
{id}
curl -X GET https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "X-API-Key: sk_test_MuLfItnPAScdhgrOsYn6Y4ur_gdMfCSMXtLciK9P8S8"
{
  "success": true,
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "invoiceNumber": 5,
    "cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
    "state": "VALIDATED",
    "emissionType": "NORMAL",
    "siatCode": 908,
    "siatDescription": "FACTURA VALIDADA",
    "clientDocumentType": 5,
    "clientDocumentNumber": "99001",
    "clientBusinessName": "EMPRESA DEMO S.R.L.",
    "clientEmail": "demo@ejemplo.com",
    "amountSubtotal": 500.00,
    "amountDiscount": 0.00,
    "amountTotal": 500.00,
    "literal": "Quinientos 00/100 Bolivianos",
    "paymentMethodCode": 1,
    "emissionDate": "2026-02-11T12:00:00",
    "details": [
      {
        "activityEconomic": "620100",
        "codeProductSin": "83141",
        "description": "Servicio de desarrollo de software",
        "quantity": 1.0,
        "unitMeasure": 58,
        "priceUnit": 500.00,
        "amountDiscount": 0.00,
        "amountSubtotal": 500.00
      }
    ],
    "pdfUrl": "https://sandbox.cucu.bo/api/v1/public/invoice/2872F...AF74/pdf",
    "xmlUrl": "https://sandbox.cucu.bo/api/v1/public/invoice/2872F...AF74/xml"
  },
  "timestamp": "2026-02-11T12:00:00"
}
Obtiene todos los detalles de una factura especifica, incluyendo datos del cliente, items, montos, estado SIAT, CUF y URLs de descarga.

Por ID (UUID)

Path Parameters

id
string
required
UUID de la factura.

Headers

X-API-Key
string
required
Tu API Key.
curl -X GET https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "X-API-Key: sk_test_MuLfItnPAScdhgrOsYn6Y4ur_gdMfCSMXtLciK9P8S8"
{
  "success": true,
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "invoiceNumber": 5,
    "cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
    "state": "VALIDATED",
    "emissionType": "NORMAL",
    "siatCode": 908,
    "siatDescription": "FACTURA VALIDADA",
    "clientDocumentType": 5,
    "clientDocumentNumber": "99001",
    "clientBusinessName": "EMPRESA DEMO S.R.L.",
    "clientEmail": "demo@ejemplo.com",
    "amountSubtotal": 500.00,
    "amountDiscount": 0.00,
    "amountTotal": 500.00,
    "literal": "Quinientos 00/100 Bolivianos",
    "paymentMethodCode": 1,
    "emissionDate": "2026-02-11T12:00:00",
    "details": [
      {
        "activityEconomic": "620100",
        "codeProductSin": "83141",
        "description": "Servicio de desarrollo de software",
        "quantity": 1.0,
        "unitMeasure": 58,
        "priceUnit": 500.00,
        "amountDiscount": 0.00,
        "amountSubtotal": 500.00
      }
    ],
    "pdfUrl": "https://sandbox.cucu.bo/api/v1/public/invoice/2872F...AF74/pdf",
    "xmlUrl": "https://sandbox.cucu.bo/api/v1/public/invoice/2872F...AF74/xml"
  },
  "timestamp": "2026-02-11T12:00:00"
}

Por CUF

Tambien puedes obtener una factura usando su Codigo Unico de Factura (CUF):
GET /api/v1/invoices/cuf/{cuf}
curl -X GET https://sandbox.cucu.bo/api/v1/invoices/cuf/2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74 \
  -H "X-API-Key: sk_test_MuLfItnPAScdhgrOsYn6Y4ur_gdMfCSMXtLciK9P8S8"
La respuesta tiene el mismo formato que la consulta por ID.