Skip to main content

​
URL Base

AmbienteURL
Sandboxhttps://sandbox.cucu.bo
Produccionhttps://api.cucu.bo

​
Autenticacion

Todas las llamadas autenticadas requieren el header X-API-Key: 
X-API-Key: sk_test_MuLfItnPAScdhgrOsYn6Y4ur_gdMfCSMXtLciK9P8S8

​
Formato de respuesta

Todas las respuestas usan el wrapper ApiResponse: 
{
  "success": true,
  "message": "Operacion exitosa",
  "data": { },
  "error": null,
  "timestamp": "2026-02-11T12:00:00"
}

​
Paginacion

Los endpoints que devuelven listas usan paginacion con page y size: 
GET /api/v1/invoices?page=0&size=20
Respuesta paginada: 
{
  "success": true,
  "data": {
    "content": [ ],
    "page": 0,
    "size": 20,
    "totalElements": 150,
    "totalPages": 8,
    "first": true,
    "last": false
  }
}
ParametroTipoDefaultDescripcion
pageinteger0Numero de pagina (inicia en 0)
sizeinteger20Elementos por pagina (max 50)

​
Content-Type

Todas las peticiones con body deben incluir: 
Content-Type: application/json

​
Versionado

La API usa versionado en la URL: /api/v1/. Cambios breaking se anuncian con anticipacion.