> ## 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
> Busca las dos gacetas oficiales de Colombia: la Gaceta del Congreso, documento por documento y en texto completo, y el Diario Oficial desde 1939.
Todo lo que el Congreso de Colombia ha publicado en su propia gaceta desde
2000, no como una lista de ediciones sino como los documentos que contienen:
proyectos de ley tal como se radicaron, las ponencias que se escribieron sobre
ellos, las actas de sesión de ambas cámaras, textos aprobados y definitivos,
informes de conciliación y objeciones presidenciales, cada uno con su texto
completo y ligado al proyecto de ley al que pertenece, de modo que un proyecto se
puede seguir por cada etapa de su trámite. Otro par de endpoints cubre las
gacetas mismas y el Diario Oficial, la publicación donde la ley colombiana entra
en vigencia, indexado desde 1939.
## Buscar documentos
`POST /co/imprenta/gaceta-documents-search/v1` Una sola búsqueda sobre todo lo que el Congreso ha publicado desde 2000, algo que ningún sitio oficial ofrece.
| Campo | Tipo | Notas |
| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `query` | string | Palabras opcionales a buscar en el título del documento, su epígrafe y su texto completo. |
| `chamber` | enum | `senado`, `camara` o `any` para ambas. Por defecto `any`. |
| `kind` | enum | Tipo opcional: `proyecto`, `ponencia`, `acta`, `texto`, `conciliacion`, `objecion`, `concepto`, `ley`, `otro` o `any`. Por defecto `any`. |
| `bill_number` | string | Opcional: solo documentos sobre este proyecto de ley o acto legislativo, p. ej. `152`. Los ceros a la izquierda se ignoran. Úsalo con `bill_year`: la numeración de los proyectos reinicia cada legislatura. |
| `bill_year` | integer | Año opcional en que se radicó el proyecto. 0 busca en todos los años. Por defecto `0`. |
| `published_from` | string | Fecha de publicación mínima opcional, `yyyy-mm-dd`. |
| `published_to` | string | Fecha de publicación máxima opcional, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `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" }'
```
La fuente entera, organizada y lista para consultar: este endpoint responde en milisegundos, a cualquier hora y siempre igual. Cada respuesta incluye `as_of`: qué tan actualizados están los datos.
Devuelve `as_of` (qué tan actualizados están los datos), los filtros
aplicados, `total` (coincidencias en todas las páginas), `page`, `per_page`,
`total_pages`, `count` y `results[]`, de más reciente a más antiguo. Cada resultado incluye `id`, `gaceta_id` y `gaceta_number` (la gaceta en que
se publicó), `chamber`, `published_at`, `title` (cómo se cita el documento),
`summary` (el epígrafe que la Gaceta imprime debajo), `kind`, `bill_number`,
`bill_year` y `bill_chamber` (el proyecto de ley o acto legislativo del que
trata, cuando el título lo nombra) y `official_url`.
`kind` es `proyecto` (un proyecto tal como se radicó), `ponencia` (un informe de
comisión sobre uno), `acta` (el acta de una sesión), `texto` (un texto aprobado o
definitivo), `conciliacion`, `objecion` (una objeción presidencial), `concepto`,
`ley` u `otro`.
Los resultados de búsqueda no incluyen el texto del documento: una sola acta de
plenaria puede llegar a doscientos mil caracteres. Lleva un `id` al endpoint
Gaceta Document para leerlo completo.
## Un documento
`POST /co/imprenta/gaceta-document/v1`
| Campo | Tipo | Notas |
| ------------- | ------ | ----------------------------------------------------------------------- |
| `document_id` | string | **Obligatorio.** El `id` de un documento de los resultados de búsqueda. |
```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" }'
```
La fuente entera, organizada y lista para consultar: este endpoint responde en milisegundos, a cualquier hora y siempre igual. Cada respuesta incluye `as_of`: qué tan actualizados están los datos.
Devuelve `as_of`, `found`, `document_id` y `document`, que incluye `text`:
el documento mismo, tal como lo publicó la Gaceta. Cada resultado incluye `id`, `gaceta_id` y `gaceta_number` (la gaceta en que
se publicó), `chamber`, `published_at`, `title` (cómo se cita el documento),
`summary` (el epígrafe que la Gaceta imprime debajo), `kind`, `bill_number`,
`bill_year` y `bill_chamber` (el proyecto de ley o acto legislativo del que
trata, cuando el título lo nombra) y `official_url`.
`kind` es `proyecto` (un proyecto tal como se radicó), `ponencia` (un informe de
comisión sobre uno), `acta` (el acta de una sesión), `texto` (un texto aprobado o
definitivo), `conciliacion`, `objecion` (una objeción presidencial), `concepto`,
`ley` u `otro`.
Unos pocos documentos se publican solo con su portada como texto; el contenido
de esos está en la edición de la gaceta, en el `official_url` de la gaceta.
## Gacetas
`POST /co/imprenta/gacetas-search/v1` La numeración de la Gaceta, por cámara y fecha.
| Campo | Tipo | Notas |
| ---------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Palabras opcionales a buscar en el número y la etiqueta de la gaceta. |
| `chamber` | enum | `senado`, `camara` o `any` para ambas. Por defecto `any`. |
| `number` | string | Número de gaceta opcional, p. ej. `1161`. Los ceros a la izquierda se ignoran. La numeración reinicia cada año y cada cámara lleva la suya, así que úsalo con un rango de fechas. |
| `published_from` | string | Fecha de publicación mínima opcional, `yyyy-mm-dd`. |
| `published_to` | string | Fecha de publicación máxima opcional, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `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" }'
```
La fuente entera, organizada y lista para consultar: este endpoint responde en milisegundos, a cualquier hora y siempre igual. Cada respuesta incluye `as_of`: qué tan actualizados están los datos.
Devuelve `as_of`, los filtros aplicados, `total`, `page`, `per_page`,
`total_pages`, `count` y `results[]`, de más reciente a más antigua. Cada gaceta
incluye `id`, `number` y `number_key`, `chamber`, `published_at`,
`printed_date`, `legacy_label` y `official_url`.
`published_at` es null en nueve gacetas cuyo año impreso no puede ser un año
(`0009`, `0200`, `0209` y similares). Esas gacetas son reales y se devuelven;
solo se omite la fecha, porque la correcta no se puede saber. Su
`printed_date` muestra lo que imprime la Gaceta.
## Diario Oficial
`POST /co/imprenta/diarios-search/v1` Ochenta y siete años del diario, por número y fecha.
| Campo | Tipo | Notas |
| ---------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `number` | string | Número de diario opcional, p. ej. `53.609` o `53609`. El separador de miles se ignora. |
| `edition` | enum | Edición opcional: `ordinaria` (la edición diaria), `extraordinaria`, `especial`, `oficio_tributario`, `otra` o `any`. Por defecto `any`. |
| `published_from` | string | Fecha de publicación mínima opcional, `yyyy-mm-dd`. |
| `published_to` | string | Fecha de publicación máxima opcional, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `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" }'
```
La fuente entera, organizada y lista para consultar: este endpoint responde en milisegundos, a cualquier hora y siempre igual. Cada respuesta incluye `as_of`: qué tan actualizados están los datos.
Devuelve `as_of`, los filtros aplicados, `total`, `page`, `per_page`,
`total_pages`, `count` y `results[]`, de más reciente a más antiguo. Cada diario
incluye `id`, `number` y `number_key`, `edition`, `published_at` y
`official_url`.
El registro llega hasta el número 23.962 del 2 de enero de 1939, pero es
irregular antes de 2000: siete años no listan ningún diario (1985, 1987, 1988,
1992, 1994, 1995 y 1998) y otros apenas unos pocos. Un resultado vacío para un
año antiguo significa que la Imprenta no lista nada para ese año, no que no se
haya publicado nada.
Esquemas, todos los campos de respuesta y un playground interactivo.