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

> Search Colombian judicial processes, resolve a case by radicación, and list its actuaciones.

Rama Judicial is Colombia's national judicial branch registry. Croma exposes
two endpoints over it: **search** processes by party, and **resolve** a case
by its registration number (radicación), which returns case metadata plus
action history in a single call.

## Search processes

`POST /co/rama-judicial/cases-by-entity/v1` finds processes by entity name.

| Field         | Type    | Notes                                                                     |
| ------------- | ------- | ------------------------------------------------------------------------- |
| `name`        | string  | **Required.** 3-200 chars. Entity name to search.                         |
| `entity_type` | enum    | Entity type: `natural` or `juridical`. Default `natural`.                 |
| `active_only` | boolean | Restrict to processes with activity in the last 30 days. Default `false`. |
| `court_code`  | string  | Narrow to a specific court.                                               |
| `page`        | integer | 1-1000. Default `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 }'
```

## Resolve by radicación

`POST /co/rama-judicial/cases-by-radicado/v1` resolves a case by its 23-digit registration
number and returns metadata plus the first 40 actuaciones (actions) available.
When no public case matches, `found` is `false` and `primary_case` is `null`.

| Field                 | Type   | Notes                                    |
| --------------------- | ------ | ---------------------------------------- |
| `registration_number` | string | **Required.** 20-25 digits (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" }'
```

## Resolve many radicados (batch)

`POST /co/rama-judicial/cases-by-radicado/v1/batch` resolves up to **50**
radicados in one request. Items are resolved concurrently and returned in the
same order, each with its own status, so one bad radicado never fails the batch.

| Field   | Type  | Notes                                                                                                 |
| ------- | ----- | ----------------------------------------------------------------------------------------------------- |
| `items` | array | **Required.** 1-50 objects, each `{ "registration_number": "…" }` (same body as the single endpoint). |

```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" }
      ] }'
```

Each item counts as one request against your quota. See [Batch requests](/batch)
for the response envelope and partial-failure handling.

<Note>
  Rama Judicial is a live upstream and can be slow or briefly unavailable.
  These endpoints may return `502 upstream_error`; retry with backoff.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, all response fields, and an interactive playground.
</Card>