> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Referencia de API

> Cada endpoint de Croma, con un playground interactivo.

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](/es/authentication).
* **Éxito**: las respuestas envuelven la carga útil bajo `data`: `{ "data": … }`.
* **Errores**: `{ "error": { "type", "code", "message" } }` con un estado distinto de 2xx. Consulta [Errores](/es/errors).
* **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](/es/rate-limits).
* **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](/es/async-jobs).

<CardGroup cols={2}>
  <Card title="Comienza" icon="bolt" href="/es/introduction">
    Obtén una llave y realiza tu primera solicitud.
  </Card>

  <Card title="Trabajos asíncronos" icon="clock" href="/es/async-jobs">
    Espera en línea, haz polling u obtén un callback para consultas de larga duración.
  </Card>
</CardGroup>