---
title: "Procuraduría Disciplinary Records"
method: POST
path: "/co/procuraduria/disciplinary-records/v1"
tags: ["Colombia", "Procuraduría"]
---

# Procuraduría Disciplinary Records

`POST /co/procuraduria/disciplinary-records/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/procuraduria/disciplinary-records/v1`
- Auth: HTTP bearer

Check a person or entity's antecedentes with the Procuraduría General de la Nación (disciplinary, penal, contractual, fiscal, and pérdida de investidura records from SIRI). `document_type` defaults to `CC`. Returns the verdict, the registered name, and the antecedente sections reproduced from the certificate.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `document_type` 'CC' | 'CE' | 'NIT' | 'PEP' | 'PPT': Colombian document type. Defaults to `CC`.
  - `document_number` string, required: Document number (alphanumeric with hyphens allowed).

## Response `200`

Successful response

- ProcuraduriaResponse
  - `data` ProcuraduriaData, required
    - `found` boolean, required: false → the document isn't registered in SIRI; other fields then empty.
    - `document_type` 'CC' | 'CE' | 'NIT' | 'PEP' | 'PPT', required
    - `document_type_label` string, required
    - `document_number` string, required
    - `full_name` string, nullable, required: Registered name, null when not found or omitted.
    - `has_records` boolean, required: true → the certificate lists one or more antecedente sections (see `records`). false → "El ciudadano no presenta antecedentes", or a document-state notice (e.g. cédula cancelled) where no antecedentes are reported; read `status` for that case.
    - `status` string, required: Verbatim verdict, the sections present, or a document-state notice.
    - `message` string, required: Full plain-text result message, for audit/display.
    - `records` object[], required: Structured antecedente sections, reproducing the certificate. Empty when the citizen has no records.
      - `category` string, required: Section title shown on the certificate.
      - `siri` string, nullable, required: "Registro SIRI No." for the section, or null when it has none.
      - `tables` object[], required: Tables under the section, in document order.
        - `heading` string, required: Heading above the table ("Sanciones", "Delitos", …).
        - `columns` string[], required: Header cells, left to right.
        - `rows` array[], required: Data rows; each row's cells align with `columns`.
          - string[]
    - `checked_at` string, nullable, required: Consultation timestamp from the source (local Colombia time), or null if absent.

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