> ## 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.

# Consultas en vivo

> Cómo responden las consultas en vivo de Croma: directo desde la fuente al momento de la solicitud, y con entrega asíncrona cuando tardan.

La mayoría de los endpoints consultan la fuente cuando llamas: estas son las
**consultas en vivo**. La respuesta viene de la fuente en ese momento, en la
misma forma JSON que cualquier otro endpoint. El resto son
[endpoints de dataset](/es/datasets), y cualquier endpoint sin la insignia
**Dataset** en su guía es en vivo.

Una consulta en vivo:

* devuelve lo que la fuente dice ahora mismo, no al corte de un refresco,
* resuelve un sujeto por llamada (una cédula, una placa, un radicado),
* consume **10 créditos** por solicitud (consulta [Límites de tasa](/es/rate-limits)).

## Latencia

La mayoría de las consultas en vivo responden en unos pocos segundos, al ritmo
de su fuente. Las más lentas corren como
[trabajos asíncronos](/es/async-jobs): espera en línea, haz polling o recibe
un callback; esa página lista qué endpoints son.

Una consulta idéntica repetida puede responder desde un resultado reciente en
caché (`X-Cache: HIT`). Las respuestas en caché consumen los mismos créditos.

## Disponibilidad

Una consulta en vivo está tan disponible como su fuente. Cuando la fuente
falla o no responde, el endpoint devuelve un `5xx` con
`type: "upstream_error"` (consulta [Errores](/es/errors)). Las consultas son
idempotentes, así que reintentar siempre es seguro.

<Card title="Datasets" icon="database" href="/es/datasets">
  El otro modo de respuesta: la fuente entera, consultada en milisegundos.
</Card>
