Saltar al contenido principal
Cada endpoint de esta referencia es una solicitud POST a https://api.croma.run, autenticada con una llave de API de tipo bearer. Elige un endpoint en la barra lateral para ver su esquema completo, una solicitud de ejemplo y un playground de “pruébalo”.

​
Convenciones

  • Auth: Authorization: Bearer <key> en cada endpoint. Consulta Autenticación.
  • Éxito: las respuestas envuelven la carga útil bajo data: { "data": … }.
  • Errores: { "error": { "type", "code", "message" } } con un estado distinto de 2xx. Consulta Errores.
  • Sin coincidencia: un registro consultado que no existe es un 200, no un 404: las consultas de un solo registro devuelven found: false y las consultas de lista devuelven un arreglo vacío.
  • Límites de tasa: se reportan mediante los encabezados de respuesta X-RateLimit-*. Consulta Límites de tasa.
  • Trabajos asíncronos: algunas consultas (Policía, SICAAC, Superfinanciera, RREE, SUNAT) pueden devolver un 202 con un trabajo que puedes consultar por polling o recibir vía callback. Consulta Trabajos asíncronos.

Comienza

Obtén una llave y realiza tu primera solicitud.

Trabajos asíncronos

Espera en línea, haz polling u obtén un callback para consultas de larga duración.