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

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, all response fields, and an interactive playground.
</Card>