Rama Judicial Emails Search

Search the Rama Judicial's official email directory: the mailbox of every Colombian despacho judicial and administrative area, with its corporation, specialty, department, city and seccional. Filter by place, kind of office or specialty (case and accents ignored), or resolve a court directly from a case: the first 12 digits of any radicado are the court_code of the despacho that holds it, and a full radicado is accepted as-is. Free text reaches the office name, the address itself, and the office's classification and place. Served by Croma (as_of says how current the data is).

Dataset endpoint: answers from the whole source in milliseconds and carries as_of.

post/co/rama-judicial/emails-search/v1

Request

Base URL: https://api.croma.run
URL: https://api.croma.run/co/rama-judicial/emails-search/v1
Auth: HTTP bearer

Headers

Idempotency-Keystring

Example:0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b

Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.

Request body

querystring

Optional search terms matched against the office name, the email address, and the office's corporation, specialty, department, city and seccional.

departmentstring

Optional department, matched from the start of the name: santander, bogota, valle. Case and accents are ignored.

citystring

Optional city, matched from the start of the name: bogota finds Bogotá D.C., medellin Medellín. Case and accents are ignored.

corporationstring

Optional kind of office (corporación), matched from the start of the name: juzgado-de-circuito, tribunal-superior, centro-de-servicios, corte-suprema. Case and accents are ignored; juzgado matches every kind of juzgado.

specialtystring

Optional specialty (especialidad), matched from the start of the name: civil, laboral, penal (which also matches the penal sub-specialties), familia. Case and accents are ignored.

account_type'' | 'despacho' | 'area'

Optional kind of mailbox: despacho for a court's own account, area for an administrative or service area. Empty returns both.

court_codestring

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.

districtstring

Optional administrative district (seccional), matched from the start of the name: bucaramanga finds Seccional Bucaramanga, nivel-central the national level. Case and accents are ignored.

pageinteger

1-based page number for paginated results.

per_pageinteger

Results per page (1-100).

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.