Search rulings
POST /co/cndj/rulings-search/v1 At least one search criterion is required.
total, count, and the matching rows.
One ruling
POST /co/cndj/ruling/v1
Full reference
Schemas, all response fields, and an interactive playground.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Search ~18,000 disciplinary rulings against Colombian judges and lawyers from the CNDJ Relatoría by text, magistrate, topic or year, and read any in full.
POST /co/cndj/rulings-search/v1 At least one search criterion is required.
| Field | Type | Notes |
|---|---|---|
query | string | Free text. |
reporting_judge | string | Reporting magistrate. |
subject | string | Topic. |
respondent | string | Party subject to the proceeding. |
matter | string | Matter. |
subtopic | string | Subtopic. |
year | string | 4-digit year. |
limit | integer | 1-100. Default 25. |
curl https://api.croma.run/co/cndj/rulings-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "prescripción", "limit": 25 }'
total, count, and the matching rows.
| Field | Notes |
|---|---|
numero_unico | 23-digit case number. Pass it (with numero_ficha) to the lookup below. |
numero_ficha | Record key for the ruling. |
magistrado_ponente | Reporting magistrate. |
contenido_radicacion | The matter under review. |
decision | The ruling’s decision. |
fecha | Ruling date. |
POST /co/cndj/ruling/v1
| Field | Type | Notes |
|---|---|---|
registration_number | string | Required. 23-digit case number from a search row. |
ficha_number | integer | Required. Record key from a search row. |
curl https://api.croma.run/co/cndj/ruling/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"registration_number": "11001010200020200012300",
"ficha_number": 12345
}'
| Field | Notes |
|---|---|
titulacion | Editorial title. |
descriptores | Topics. |
fuentes_normativas | Legal sources cited. |
salvamentos_aclaraciones | Dissenting and concurring opinions. |
pdf_url | Link to the ruling document. |
texto | Extracted full text, when the document carries a text layer. |