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

# Rama Judicial Emails by Court

`POST /co/rama-judicial/emails-by-court/v1`

## Request

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

Resolve the official mailbox of a Colombian court from its 12-digit court code (código de despacho), or directly from a full radicado: its first 12 digits identify the court where the case is filed, so a case number answers "whom do I email about this case" in one call. Returns every account the directory holds for that code, the despacho's own mailbox first, then its service and filing areas. 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
  - `court_code` string, required: The court's 12-digit code (código de despacho), or a full 20-25-digit radicado: its first 12 digits identify the court where the case is filed.

## Response `200`

Successful response

- RamaJudicialEmailsByCourtResponse
  - `data` RamaJudicialEmailsByCourtData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `found` boolean, required: Whether the directory holds any mailbox for this court code. When false, mailboxes is empty.
    - `court_code` string, required
    - `count` number, required
    - `mailboxes` 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)