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

# Rama Judicial

> Busca procesos judiciales colombianos, resuelve un caso por radicación y lista sus actuaciones.

Rama Judicial es el registro nacional de la rama judicial de Colombia. Croma
expone dos endpoints sobre él: **buscar** procesos por parte y **resolver** un
caso por su número de radicación (radicación), que devuelve los metadatos del
caso junto con el historial de actuaciones en una sola llamada.

## Buscar procesos

`POST /co/rama-judicial/cases-by-entity/v1` encuentra procesos por nombre de entidad.

| Campo         | Tipo    | Notas                                                                           |
| ------------- | ------- | ------------------------------------------------------------------------------- |
| `name`        | string  | **Obligatorio.** 3-200 caracteres. Nombre de la entidad a buscar.               |
| `entity_type` | enum    | Tipo de entidad: `natural` o `juridical`. Por defecto `natural`.                |
| `active_only` | boolean | Restringe a procesos con actividad en los últimos 30 días. Por defecto `false`. |
| `court_code`  | string  | Acota a un juzgado específico.                                                  |
| `page`        | integer | 1-1000. Por defecto `1`.                                                        |

```bash theme={"dark"}
curl https://api.croma.run/co/rama-judicial/cases-by-entity/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "PEDRO CIFUENTES", "entity_type": "natural", "page": 1 }'
```

## Resolver por radicación

`POST /co/rama-judicial/cases-by-radicado/v1` resuelve un caso por su número de
radicación de 23 dígitos y devuelve los metadatos junto con las primeras 40
actuaciones disponibles. Cuando ningún caso público coincide, `found` es `false`
y `primary_case` es `null`.

| Campo                 | Tipo   | Notas                                        |
| --------------------- | ------ | -------------------------------------------- |
| `registration_number` | string | **Obligatorio.** 20-25 dígitos (radicación). |

```bash theme={"dark"}
curl https://api.croma.run/co/rama-judicial/cases-by-radicado/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "registration_number": "11001600001720180327700" }'
```

## Resolver muchos radicados (lote)

`POST /co/rama-judicial/cases-by-radicado/v1/batch` resuelve hasta **50**
radicados en una sola solicitud. Los elementos se resuelven de forma concurrente
y se devuelven en el mismo orden, cada uno con su propio estado, así que un
radicado defectuoso nunca hace fallar el lote.

| Campo   | Tipo  | Notas                                                                                                                       |
| ------- | ----- | --------------------------------------------------------------------------------------------------------------------------- |
| `items` | array | **Obligatorio.** De 1 a 50 objetos, cada uno `{ "registration_number": "…" }` (el mismo cuerpo que el endpoint individual). |

```bash theme={"dark"}
curl https://api.croma.run/co/rama-judicial/cases-by-radicado/v1/batch \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "items": [
        { "registration_number": "11001600001720180327700" },
        { "registration_number": "05001310300120190012300" }
      ] }'
```

Cada elemento cuenta como una solicitud contra tu cuota. Consulta
[Solicitudes en lote](/es/batch) para el sobre de respuesta y el manejo de
fallas parciales.

<Note>
  Rama Judicial es una fuente en vivo y puede responder con lentitud o estar
  brevemente no disponible. Estos endpoints pueden devolver `502 upstream_error`;
  reintenta con backoff.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>