---
title: "CNDJ Ruling"
method: POST
path: "/co/cndj/ruling/v1"
tags: ["Colombia", "Relatoría de la CNDJ"]
---

# CNDJ Ruling

`POST /co/cndj/ruling/v1`

## Request

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

Retrieve one CNDJ disciplinary ruling by its `registration_number` + `ficha_number` key: the editorial fields (titulación, descriptores, fuentes normativas, salvamentos) plus the ruling document and its extracted full text when it carries a text layer. `found: false` when no document is stored for that key.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `registration_number` string, required: Numero unico de la radicación (`numero_unico` de la búsqueda).
  - `ficha_number` integer, required: Número de ficha de la radicación (`numero_ficha` de la búsqueda).

## Response `200`

Successful response

- CndjRulingResponse
  - `data` CndjRulingData, required
    - `found` boolean, required
    - `numero_unico` string, required
    - `numero_ficha` number, required
    - `ruling` object, nullable, required
      - `numero_unico` string, required
      - `numero_ficha` number, required
      - `titulacion` string, nullable, required: Editorial title of the ficha.
      - `notas_relatorias` string, nullable, required: Editorial notes.
      - `descriptores` string, nullable, required: Topic descriptors.
      - `fuentes_normativas` string, nullable, required: Normative sources cited.
      - `salvamento_aclaraciones` string, nullable, required: Dissenting / clarifying opinions.
      - `pdf_url` string, required: Public URL of the full ruling PDF.
      - `texto` string, nullable, required: Extracted full text of the PDF; null when it carries no text layer.

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