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

# Imprenta Nacional

> Busque as duas gazetas oficiais da Colômbia: a Gaceta del Congreso, documento por documento e em texto completo, e o Diario Oficial desde 1939.

Tudo o que o Congresso da Colômbia publicou em sua própria gazeta desde 2000,
não como uma lista de edições mas como os documentos que elas contêm: projetos de
lei como foram apresentados, os pareceres escritos sobre eles, as atas de sessão
das duas câmaras, textos aprovados e definitivos, relatórios de conciliação e
objeções presidenciais, cada um com seu texto completo e ligado ao projeto de lei
a que pertence, de modo que um projeto pode ser acompanhado em cada etapa de sua
tramitação. Outro par de endpoints cobre as próprias edições da Gaceta e o Diario
Oficial, a publicação onde a lei colombiana entra em vigor, indexado desde 1939.

## Buscar documentos

`POST /co/imprenta/gaceta-documents-search/v1` Uma única busca sobre tudo o que o Congresso publicou desde 2000, algo que nenhum site oficial oferece.

| Campo            | Tipo    | Notas                                                                                                                                                                                          |
| ---------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`          | string  | Palavras opcionais a buscar no título do documento, seu epígrafe e seu texto completo.                                                                                                         |
| `chamber`        | enum    | `senado`, `camara` ou `any` para ambas. Por padrão `any`.                                                                                                                                      |
| `kind`           | enum    | Tipo opcional: `proyecto`, `ponencia`, `acta`, `texto`, `conciliacion`, `objecion`, `concepto`, `ley`, `otro` ou `any`. Por padrão `any`.                                                      |
| `bill_number`    | string  | Opcional: só documentos sobre este projeto de lei ou ato legislativo, p. ex. `152`. Zeros à esquerda são ignorados. Use com `bill_year`: a numeração dos projetos reinicia a cada legislatura. |
| `bill_year`      | integer | Ano opcional em que o projeto foi apresentado. 0 busca em todos os anos. Por padrão `0`.                                                                                                       |
| `published_from` | string  | Data de publicação mínima opcional, `yyyy-mm-dd`.                                                                                                                                              |
| `published_to`   | string  | Data de publicação máxima opcional, `yyyy-mm-dd`.                                                                                                                                              |
| `page`           | integer | Número da página, começa em 1. Por padrão `1`.                                                                                                                                                 |
| `per_page`       | integer | Resultados por página (1-50). Por padrão `20`.                                                                                                                                                 |

```bash theme={"dark"}
curl https://api.croma.run/co/imprenta/gaceta-documents-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "reforma pensional", "kind": "ponencia" }'
```

<Note>
  A fonte inteira, organizada e pronta para consultar: este endpoint responde em milissegundos, a qualquer hora e sempre igual. Cada resposta traz `as_of`: o quão atuais são os dados.
</Note>

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total`
(correspondências em todas as páginas), `page`, `per_page`, `total_pages`,
`count` e `results[]`, do mais recente ao mais antigo. Cada resultado traz `id`, `gaceta_id` e `gaceta_number` (a edição em que foi
publicado), `chamber`, `published_at`, `title` (como o documento é citado),
`summary` (o epígrafe que a Gaceta imprime abaixo), `kind`, `bill_number`,
`bill_year` e `bill_chamber` (o projeto de lei ou ato legislativo de que trata,
quando o título o nomeia) e `official_url`.

`kind` é `proyecto` (um projeto como foi apresentado), `ponencia` (um parecer de
comissão sobre um), `acta` (a ata de uma sessão), `texto` (um texto aprovado ou
definitivo), `conciliacion`, `objecion` (uma objeção presidencial), `concepto`,
`ley` ou `otro`.

<Note>
  Os resultados de busca não trazem o texto do documento: uma única ata de
  plenário pode chegar a duzentos mil caracteres. Leve um `id` ao endpoint Gaceta
  Document para lê-lo por inteiro.
</Note>

## Um documento

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

| Campo         | Tipo   | Notas                                                            |
| ------------- | ------ | ---------------------------------------------------------------- |
| `document_id` | string | **Obrigatório.** O `id` de um documento dos resultados de busca. |

```bash theme={"dark"}
curl https://api.croma.run/co/imprenta/gaceta-document/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_id": "87176" }'
```

<Note>
  A fonte inteira, organizada e pronta para consultar: este endpoint responde em milissegundos, a qualquer hora e sempre igual. Cada resposta traz `as_of`: o quão atuais são os dados.
</Note>

Retorna `as_of`, `found`, `document_id` e `document`, que traz `text`: o
documento em si, como a Gaceta o publicou. Cada resultado traz `id`, `gaceta_id` e `gaceta_number` (a edição em que foi
publicado), `chamber`, `published_at`, `title` (como o documento é citado),
`summary` (o epígrafe que a Gaceta imprime abaixo), `kind`, `bill_number`,
`bill_year` e `bill_chamber` (o projeto de lei ou ato legislativo de que trata,
quando o título o nomeia) e `official_url`.

`kind` é `proyecto` (um projeto como foi apresentado), `ponencia` (um parecer de
comissão sobre um), `acta` (a ata de uma sessão), `texto` (um texto aprovado ou
definitivo), `conciliacion`, `objecion` (uma objeção presidencial), `concepto`,
`ley` ou `otro`.

<Note>
  Alguns poucos documentos são publicados apenas com a capa como texto; o
  conteúdo desses está na edição da gaceta, no `official_url` da gaceta.
</Note>

## Edições

`POST /co/imprenta/gacetas-search/v1` A numeração da Gaceta, por câmara e data.

| Campo            | Tipo    | Notas                                                                                                                                                                   |
| ---------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`          | string  | Palavras opcionais a buscar no número e no rótulo da edição.                                                                                                            |
| `chamber`        | enum    | `senado`, `camara` ou `any` para ambas. Por padrão `any`.                                                                                                               |
| `number`         | string  | Número de edição opcional, p. ex. `1161`. Zeros à esquerda são ignorados. A numeração reinicia a cada ano e cada câmara tem a sua, então use com um intervalo de datas. |
| `published_from` | string  | Data de publicação mínima opcional, `yyyy-mm-dd`.                                                                                                                       |
| `published_to`   | string  | Data de publicação máxima opcional, `yyyy-mm-dd`.                                                                                                                       |
| `page`           | integer | Número da página, começa em 1. Por padrão `1`.                                                                                                                          |
| `per_page`       | integer | Resultados por página (1-50). Por padrão `20`.                                                                                                                          |

```bash theme={"dark"}
curl https://api.croma.run/co/imprenta/gacetas-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "chamber": "senado", "published_from": "2026-08-01" }'
```

<Note>
  A fonte inteira, organizada e pronta para consultar: este endpoint responde em milissegundos, a qualquer hora e sempre igual. Cada resposta traz `as_of`: o quão atuais são os dados.
</Note>

Retorna `as_of`, os filtros aplicados, `total`, `page`, `per_page`,
`total_pages`, `count` e `results[]`, da mais recente à mais antiga. Cada edição
traz `id`, `number` e `number_key`, `chamber`, `published_at`, `printed_date`,
`legacy_label` e `official_url`.

<Note>
  `published_at` é null em nove edições cujo ano impresso não pode ser um ano
  (`0009`, `0200`, `0209` e afins). Essas edições são reais e são retornadas; só
  a data é omitida, porque a correta não é conhecível. O `printed_date` mostra o
  que a Gaceta imprime.
</Note>

## Diario Oficial

`POST /co/imprenta/diarios-search/v1` Oitenta e sete anos do diário, por número e data.

| Campo            | Tipo    | Notas                                                                                                                                 |
| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `number`         | string  | Número da edição opcional, p. ex. `53.609` ou `53609`. O separador de milhares é ignorado.                                            |
| `edition`        | enum    | Edição opcional: `ordinaria` (a edição diária), `extraordinaria`, `especial`, `oficio_tributario`, `otra` ou `any`. Por padrão `any`. |
| `published_from` | string  | Data de publicação mínima opcional, `yyyy-mm-dd`.                                                                                     |
| `published_to`   | string  | Data de publicação máxima opcional, `yyyy-mm-dd`.                                                                                     |
| `page`           | integer | Número da página, começa em 1. Por padrão `1`.                                                                                        |
| `per_page`       | integer | Resultados por página (1-50). Por padrão `20`.                                                                                        |

```bash theme={"dark"}
curl https://api.croma.run/co/imprenta/diarios-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "published_from": "2026-08-01" }'
```

<Note>
  A fonte inteira, organizada e pronta para consultar: este endpoint responde em milissegundos, a qualquer hora e sempre igual. Cada resposta traz `as_of`: o quão atuais são os dados.
</Note>

Retorna `as_of`, os filtros aplicados, `total`, `page`, `per_page`,
`total_pages`, `count` e `results[]`, do mais recente ao mais antigo. Cada
edição traz `id`, `number` e `number_key`, `edition`, `published_at` e
`official_url`.

<Note>
  O registro alcança o número 23.962 de 2 de janeiro de 1939, mas é irregular
  antes de 2000: sete anos não listam nenhuma edição (1985, 1987, 1988, 1992,
  1994, 1995 e 1998) e outros apenas algumas. Um resultado vazio para um ano
  antigo significa que a Imprenta não lista nada para ele, não que nada tenha
  sido publicado.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>
