---
title: "Rama Judicial Emails Search"
method: POST
path: "/co/rama-judicial/emails-search/v1"
tags: ["Colombia", "Rama Judicial"]
---

# Rama Judicial Emails Search

`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

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

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `query` string: Optional search terms 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`, `valle`. Case and accents are ignored.
  - `city` string: Optional city, matched from the start of the name: `bogota` finds Bogotá D.C., `medellin` Medellín. Case and accents are ignored.
  - `corporation` string: 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.
  - `specialty` string: 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_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.
  - `district` string: 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.
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Results per page (1-100).

## Response `200`

Successful response

- RamaJudicialEmailsSearchResponse
  - `data` RamaJudicialEmailsSearchData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `query` string, required
    - `department` string, nullable, required
    - `city` string, nullable, required
    - `corporation` string, nullable, required
    - `specialty` string, nullable, required
    - `account_type` string, nullable, required
    - `court_code` string, nullable, required
    - `district` string, nullable, required
    - `total` number, required: Matches, counted up to 1000.
    - `total_is_exact` boolean, required: False when more than 1000 match: `total` is then 1000, and the pages go on.
    - `page` number, required
    - `per_page` number, required
    - `total_pages` number, required: Pages over `total`; there are more when `total_is_exact` is false.
    - `count` number, required
    - `results` object[], required
      - `email` string, required: The mailbox address, e.g. `jcctobog01@cendoj.ramajudicial.gov.co`.
      - `name` string, nullable, required: The office or area as the directory names it, e.g. "Juzgado 01 Civil Circuito - Bogotá - Bogotá D.C.".
      - `account_type` string, nullable, required: What the mailbox belongs to, as the directory labels it: "Despacho Judicial" (a court) or "Área" (an administrative or service area).
      - `corporation` string, nullable, required: The kind of office, as the directory writes it: "Juzgado De Circuito", "Tribunal Superior", "Centro De Servicios Judiciales", "Corte Suprema De Justicia" and others.
      - `corporation_key` string, nullable, required: The corporation in canonical form, e.g. `juzgado-de-circuito`. Filter on this by prefix.
      - `specialty` string, nullable, required: The office's specialty, as the directory writes it: "Civil", "Laboral", "Penal Con Función De Conocimiento", "No Aplica" on administrative areas, and others.
      - `specialty_key` string, nullable, required: The specialty in canonical form, e.g. `penal-con-funcion-de-conocimiento`. Filter on this by prefix.
      - `department` string, nullable, required: The department, as the directory writes it: "Bogotá", "Santander", "N. De Santander".
      - `department_key` string, nullable, required: The department in canonical form, e.g. `n-de-santander`. Filter on this by prefix.
      - `city` string, nullable, required: The city, as the directory writes it: "Bogotá D.C.", "Medellín", "Paz De Ariporo".
      - `city_key` string, nullable, required: The city in canonical form, e.g. `bogota-d-c`. Filter on this by prefix.
      - `district` string, nullable, required: The judicial branch's administrative district for the office, as the directory writes it: "Seccional Bucaramanga", "Seccional Nivel Central".
      - `district_key` string, nullable, required: The district in canonical form with the `Seccional` prefix dropped, e.g. `bucaramanga`, `nivel-central`. Filter on this by prefix.
      - `court_code` string, nullable, required: The office's 12-digit code (código de despacho). It is the first 12 digits of every radicado filed at the office, so a case number resolves the mailbox of the court that holds it.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)