---
title: "CNDJ Rulings Search"
method: POST
path: "/co/cndj/rulings-search/v1"
tags: ["Colombia", "Relatoría de la CNDJ"]
---

# CNDJ Rulings Search

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

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/cndj/rulings-search/v1`
- Auth: HTTP bearer

Search disciplinary rulings from the Relatoría de la Comisión Nacional de Disciplina Judicial (CNDJ) by free text or the advanced filters (reporting magistrate, topic, respondent, matter, subtopic, filing year). Returns the matching summaries with their `numero_unico` + `numero_ficha` key; read one in full with `cndj-ruling`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `query` string: Texto de búsqueda general (providencias disciplinarias).
  - `reporting_judge` string: Filtro por magistrado ponente.
  - `subject` string: Filtro por tema.
  - `respondent` string: Filtro por nombre del disciplinado.
  - `matter` string: Filtro por asunto.
  - `subtopic` string: Filtro por restrictor.
  - `year` string: Filtro opcional por año de radicación (4 dígitos).
  - `limit` integer: Número máximo de resultados a devolver.

## Response `200`

Successful response

- CndjRulingsSearchResponse
  - `data` CndjRulingsSearchData, required
    - `query` string, required: Echo of the terms searched (general text or the joined advanced filters).
    - `total` number, required: Total matches reported by the source.
    - `count` number, required: How many summaries this response carries (bounded by `limit`).
    - `limit` number, required
    - `results` object[], required
      - `numero_unico` string, required: 23-digit numero unico de radicación. Part of the record key.
      - `numero_ficha` number, required: Ficha number within the radicación. Part of the record key.
      - `magistrado_ponente` string, nullable, required
      - `contenido_radicacion` string, nullable, required: What the filing is about (subject line of the radicación).
      - `decision` string, nullable, required: The decision / ruling text.
      - `fecha` string, nullable, required: Providencia date (ISO `YYYY-MM-DD`); null when the source omits it.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)