Rama Judicial

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

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

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

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 for the response envelope and partial-failure handling.

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

Full reference

Schemas, all response fields, and an interactive playground.

Get Started

Colombia

Peru

Global

Search processes

Resolve by radicación

Resolve many radicados (batch)

Full reference

​Search processes

​Resolve by radicación

​Resolve many radicados (batch)

Full reference

Search processes

Resolve by radicación

Resolve many radicados (batch)