---
title: "Gaceta del Congreso Document"
method: POST
path: "/co/imprenta/gaceta-document/v1"
tags: ["Colombia", "Imprenta Nacional"]
---

# Gaceta del Congreso Document

`POST /co/imprenta/gaceta-document/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/imprenta/gaceta-document/v1`
- Auth: HTTP bearer

Retrieve one document published in the Gaceta del Congreso by its `document_id` from the search results (e.g. `87176`), with its full text as the Gaceta published it, the issue it appeared in, and the proyecto de ley it belongs to.

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `document_id` string, required: The document's identifier, e.g. `87176`.

## Response `200`

Successful response

- ImprentaGacetaDocumentResponse
  - `data` ImprentaGacetaDocumentData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `found` boolean, required
    - `document_id` string, required
    - `document` object, nullable, required
      - `id` string, required: The consecutivo the Imprenta keys the document on, e.g. `87176`. Unique across every gaceta and both chambers.
      - `gaceta_id` string, required: Id of the gaceta this document was published in.
      - `gaceta_number` string, required: Number of the gaceta this document was published in.
      - `chamber` 'camara' | 'senado', required: The chamber whose run the gaceta belongs to: `senado` or `camara`.
      - `published_at` string, nullable, required: `yyyy-mm-dd` the gaceta carrying this document was published.
      - `title` string, required: How the document is cited, e.g. "Informe de Ponencia para Primer Debate al Proyecto de Ley 318 de 2009 Senado" or "Acta de Plenaria 22 del 16 de Octubre de 2013 Senado".
      - `summary` string, required: The epígrafe the Imprenta prints under the title — for a bill, the "por la cual se..." clause. Empty when the document has none.
      - `kind` 'proyecto' | 'ponencia' | 'acta' | 'texto' | 'conciliacion' | 'objecion' | 'concepto' | 'ley' | 'otro', required: What the title says the document is: `proyecto` (a bill as filed), `ponencia` (a committee report on one), `acta` (the minutes of a sitting), `texto` (an approved or definitive text), `conciliacion`, `objecion` (a presidential objection), `concepto`, `ley` (a law as enacted), or `otro`. Read off the title, because the Imprenta's own label is blank after 2020.
      - `bill_number` string, nullable, required: Number of the proyecto de ley or acto legislativo the document is about, when the title names one. Null for actas and anything not tied to a bill.
      - `bill_year` number, nullable, required: Year of the bill the document is about, when the title names one.
      - `bill_chamber` 'camara' | 'senado', nullable, required: The chamber the bill was filed in, when the title names it. A bill keeps its filing chamber's number as it moves, so this is not always the chamber that published the gaceta.
      - `text` string, required: The document's full text, as the Imprenta publishes it. This is the document itself, not a summary or an extract.
      - `official_url` string, required: The Imprenta's page for this document, inside its gaceta.

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