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

> Busca fallos disciplinarios contra jueces y abogados y lee cualquier fallo completo.

Fallos disciplinarios contra jueces y abogados desde la Relatoría de la Comisión
Nacional de Disciplina Judicial (CNDJ): \~18.000 fallos, con búsqueda por texto,
magistrado, tema, disciplinado, asunto o año. Busca primero y luego lee un fallo
completo.

## Buscar fallos

`POST /co/cndj/rulings-search/v1`

Se requiere al menos un criterio de búsqueda.

| Campo             | Tipo    | Notas                    |
| ----------------- | ------- | ------------------------ |
| `query`           | string  | Texto libre.             |
| `reporting_judge` | string  | Magistrado ponente.      |
| `subject`         | string  | Tema.                    |
| `respondent`      | string  | Parte sujeta al proceso. |
| `matter`          | string  | Asunto.                  |
| `subtopic`        | string  | Subtema.                 |
| `year`            | string  | Año de 4 dígitos.        |
| `limit`           | integer | 1-100. Por defecto `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 }'
```

Devuelve `total`, `count` y las filas coincidentes.

| Campo                  | Notas                                                                           |
| ---------------------- | ------------------------------------------------------------------------------- |
| `numero_unico`         | Número único de 23 dígitos. Úsalo (con `numero_ficha`) en la consulta de abajo. |
| `numero_ficha`         | Clave del registro del fallo.                                                   |
| `magistrado_ponente`   | Magistrado ponente.                                                             |
| `contenido_radicacion` | El asunto en revisión.                                                          |
| `decision`             | La decisión del fallo.                                                          |
| `fecha`                | Fecha del fallo.                                                                |

## Un fallo

`POST /co/cndj/ruling/v1`

| Campo                 | Tipo    | Notas                                                                    |
| --------------------- | ------- | ------------------------------------------------------------------------ |
| `registration_number` | string  | **Obligatorio.** Número único de 23 dígitos de un resultado de búsqueda. |
| `ficha_number`        | integer | **Obligatorio.** Clave del registro de un resultado de búsqueda.         |

```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 }'
```

Devuelve los campos editoriales del fallo, además de un enlace al documento y su
texto completo cuando está disponible.

| Campo                      | Notas                                                             |
| -------------------------- | ----------------------------------------------------------------- |
| `titulacion`               | Título editorial.                                                 |
| `descriptores`             | Temas.                                                            |
| `fuentes_normativas`       | Fuentes normativas citadas.                                       |
| `salvamentos_aclaraciones` | Salvamentos y aclaraciones de voto.                               |
| `pdf_url`                  | Enlace al documento del fallo.                                    |
| `texto`                    | Texto completo extraído, cuando el documento tiene capa de texto. |

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, campos de respuesta y un playground interactivo.
</Card>