Skip to main content
POST
Rama Judicial Emails Search

Authorizations

Authorization
string
header
required

Use Authorization: Bearer YOUR_API_KEY

Headers

Idempotency-Key
string

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.

Maximum string length: 255
Example:

"0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b"

Body

application/json
query
string
default:""

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

Maximum string length: 200
department
string
default:""

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

Maximum string length: 60
city
string
default:""

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

Maximum string length: 60
corporation
string
default:""

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.

Maximum string length: 120
specialty
string
default:""

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.

Maximum string length: 120
account_type
enum<string>
default:""

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

Available options:
,
despacho,
area
court_code
string
default:""

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.

Pattern: ^(\d{12}|\d{20,25})?$
district
string
default:""

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.

Maximum string length: 60
page
integer
default:1

1-based page number for paginated results.

Required range: 1 <= x <= 1000
per_page
integer
default:20

Results per page (1-100).

Required range: 1 <= x <= 100

Response

Successful response

data
object
required