Rama Judicial

Rama Judicial is Colombia’s national judicial branch registry. Croma exposes four endpoints over it: search processes by party, resolve a case by its registration number (radicación), which returns case metadata plus action history in a single call, and the email directory, twice over: the official mailbox of every despacho judicial and administrative area, browsable by place and specialty, or resolved directly from a court code or a radicado.

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

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.

Find a court’s email

POST /co/rama-judicial/emails-search/v1 Dataset Searches the judicial branch’s official mailbox directory: every despacho judicial and administrative area, filterable by place, kind of office, specialty, seccional, or the court code that prefixes every radicado.

Field	Type	Notes
`query`	string	Optional words matched against the office name, the email address, and the office’s corporation, specialty, department, city and seccional.
`department`	string	Optional department, matched from the start of the name: `santander`, `bogota`. Case and accents are ignored.
`city`	string	Optional city, matched from the start of the name: `bogota` finds Bogotá D.C.
`corporation`	string	Optional kind of office, matched from the start of the name: `juzgado` matches every kind of juzgado, `tribunal-superior`, `centro-de-servicios`, `corte-suprema`.
`specialty`	string	Optional specialty, matched from the start of the name: `civil`, `laboral`, `familia`, `penal` (which also matches the penal sub-specialties).
`account_type`	enum	Optional kind of mailbox: `despacho` for a court’s own account, `area` for an administrative or service area. Empty returns both.
`court_code`	string	Optional 12-digit court code (código de despacho). A full 20-25-digit radicado is also accepted: its first 12 digits identify the office where the case is filed, so this resolves “which court holds this case, and what is its email” in one call.
`district`	string	Optional administrative district (seccional), matched from the start of the name: `bucaramanga`, `nivel-central`.
`page`	integer	1-based page number. Default `1`.
`per_page`	integer	Results per page (1-100). Default `20`.

curl https://api.croma.run/co/rama-judicial/emails-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "city": "bucaramanga", "specialty": "penal" }'

Returns as_of (how current the data is), the applied filters, total, page, per_page, total_pages, count and results[], ordered by office name. Every result carries email, name, account_type (“Despacho Judicial” or “Área”), corporation, specialty, department, city, district (the seccional), court_code, and the canonical *_key twins the filters match by prefix.

The directory is served from Croma’s own copy, refreshed weekly from the Rama Judicial’s official directory, so searches answer fast and do not depend on the upstream being reachable. as_of says when the copy was last brought up to date.

Resolve a court’s email from a case

POST /co/rama-judicial/emails-by-court/v1 Dataset Resolves the official mailbox of one court from its 12-digit code, or directly from a full radicado. No paging: every account the directory holds for the code comes back at once, the despacho’s own mailbox first.

Field	Type	Notes
`court_code`	string	Required. The 12-digit court code (código de despacho), or a full 20-25-digit radicado: its first 12 digits identify the court where the case is filed. The `court_code` of any emails-search result and the first 12 digits of any `registration_number` are both valid values.

curl https://api.croma.run/co/rama-judicial/emails-by-court/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "court_code": "110013103021" }'

Returns as_of, found, the (sliced) court_code, count and mailboxes[], each with the same fields as an emails-search result.

A code the directory does not hold returns found: false with HTTP 200, not an error. Some courts publish no dedicated mailbox and are served by a centro de servicios; searching the email directory by place and specialty is the fallback.

The case endpoints reach a live upstream that can be slow or briefly unavailable, and may return 502 upstream_error; retry with backoff. The email directory is served from Croma’s own copy and does not depend on it.

Full reference

Schemas, all response fields, and an interactive playground.

Get Started

Request types

Countries

Search processes

Resolve by radicación

Resolve many radicados (batch)

Find a court’s email

Resolve a court’s email from a case

Full reference

​Search processes

​Resolve by radicación

​Resolve many radicados (batch)

​Find a court’s email

​Resolve a court’s email from a case

Full reference

Search processes

Resolve by radicación

Resolve many radicados (batch)

Find a court’s email

Resolve a court’s email from a case