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

> Busque processos judiciais colombianos, resolva um caso por radicación e liste suas actuaciones.

Rama Judicial é o registro nacional do poder judiciário da Colômbia. A Croma
expõe dois endpoints sobre ele: **buscar** processos por parte e **resolver** um
caso pelo seu número de registro (radicación), que retorna os metadados do
caso junto com o histórico de actuaciones em uma única chamada.

## Buscar processos

`POST /co/rama-judicial/cases-by-entity/v1` encontra processos por nome de entidade.

| Campo         | Tipo    | Notas                                                                        |
| ------------- | ------- | ---------------------------------------------------------------------------- |
| `name`        | string  | **Obrigatório.** 3-200 caracteres. Nome da entidade a buscar.                |
| `entity_type` | enum    | Tipo de entidade: `natural` ou `juridical`. Por padrão `natural`.            |
| `active_only` | boolean | Restringe a processos com atividade nos últimos 30 dias. Por padrão `false`. |
| `court_code`  | string  | Restringe a um juzgado específico.                                           |
| `page`        | integer | 1-1000. Por padrão `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` resolve um caso pelo seu número de
radicación de 23 dígitos e retorna os metadados junto com as primeiras 40
actuaciones disponíveis. Quando nenhum caso público coincide, `found` é `false`
e `primary_case` é `null`.

| Campo                 | Tipo   | Notas                                        |
| --------------------- | ------ | -------------------------------------------- |
| `registration_number` | string | **Obrigatório.** 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 vários radicados (lote)

`POST /co/rama-judicial/cases-by-radicado/v1/batch` resolve até **50**
radicados em uma única solicitação. Os itens são resolvidos de forma concorrente
e devolvidos na mesma ordem, cada um com seu próprio status, de modo que um
radicado defeituoso nunca faz o lote falhar.

| Campo   | Tipo  | Notas                                                                                                                |
| ------- | ----- | -------------------------------------------------------------------------------------------------------------------- |
| `items` | array | **Obrigatório.** De 1 a 50 objetos, cada um `{ "registration_number": "…" }` (o mesmo corpo do 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 item conta como uma solicitação contra a sua cota. Consulte
[Solicitações em lote](/pt/batch) para o envelope de resposta e o tratamento de
falhas parciais.

<Note>
  Rama Judicial é uma fonte ao vivo e pode responder com lentidão ou ficar
  brevemente indisponível. Estes endpoints podem retornar `502 upstream_error`;
  tente novamente com backoff.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>