> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CNDJ

> Search disciplinary rulings against judges and lawyers, and read any ruling in full.

Disciplinary rulings against judges and lawyers from the Relatoría de la
Comisión Nacional de Disciplina Judicial (CNDJ): \~18,000 rulings, searchable by
text, magistrate, topic, party, matter, or year. Search first, then read one
ruling in full.

## Search rulings

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

```bash theme={"dark"}
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 }'
```

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

## One ruling

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

```bash theme={"dark"}
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 }'
```

Returns the editorial fields for the ruling, plus a link to the document and its
full text when available.

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

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, response fields, and an interactive playground.
</Card>