> ## 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.
# SIC
> Busca en el registro normativo y en el Boletín Jurídico de la Superintendencia de Industria y Comercio de Colombia: sus resoluciones, circulares, la Circular Única, su doctrina y las decisiones y conceptos que destaca, con cada archivo original; consulta cualquiera.
La Superintendencia de Industria y Comercio (SIC) es la autoridad colombiana de protección al consumidor, datos personales, propiedad industrial, competencia y reglamentos técnicos, y la mayor jurisdicción de derecho del consumo del país. Aquí están dos de sus publicaciones. Su registro normativo reúne unos 7.600 actos: las leyes y decretos que aplica, sus resoluciones y circulares, cada título de la Circular Única a medida que se reexpide, la doctrina de su relatoría de competencia, sus proyectos de resolución y sus nombramientos, cada uno con sus fechas de expedición y publicación, el resumen de la Superintendencia y cada archivo adjunto. Su Boletín Jurídico reúne unos 750 ítems desde 2019: las decisiones y conceptos que la Oficina Asesora Jurídica decide destacar, por área, con un resumen y el documento de fondo, más los conceptos que publica junto a ellos.
Busca en cualquiera de los dos por tipo, área, fecha o texto libre sobre los títulos y resúmenes. Los ítems nuevos aparecen al día siguiente de que la Superintendencia los publica.
La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
## Buscar en el registro
`POST /co/sic-normativa/regulations-search/v1` Dataset
Una sola búsqueda sobre cada acto del registro normativo de la Superintendencia, filtrada por tipo, área, fecha de expedición o fecha de publicación.
| Campo | Tipo | Notas |
| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `query` | string | Palabras opcionales que se buscan en el título y el resumen. |
| `kind` | string | Tipo opcional tal como lo clasifica el registro, p. ej. `Resoluciones`, `Circulares`, `Títulos Circular única`, `Leyes`, `Decretos`, `Doctrina`, `Nombramientos`, `Proyectos de resolución`. No importan mayúsculas ni tildes. |
| `topic` | string | Área opcional de la Superintendencia, p. ej. `Protección al Consumidor`, `Protección de Datos Personales`, `Propiedad Industrial`, `Protección a la Competencia`, comparada desde el inicio. No importan mayúsculas ni tildes. |
| `issued_from` | string | Opcional: solo actos expedidos en esta fecha o después, `yyyy-mm-dd`. |
| `issued_to` | string | Opcional: solo actos expedidos en esta fecha o antes, `yyyy-mm-dd`. |
| `published_from` | string | Opcional: solo actos publicados en esta fecha o después, `yyyy-mm-dd`. |
| `published_to` | string | Opcional: solo actos publicados en esta fecha o antes, `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/sic-normativa/regulations-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "habeas data", "kind": "Circulares" }'
```
Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, del publicado más recientemente al más antiguo. Cada resultado incluye `id` (el número permanente del acto en el registro), `title`, `kinds[]` (como lo clasifica el registro: `Resoluciones`, `Circulares`, `Títulos Circular única`, `Leyes`, `Decretos`, `Doctrina`, `Nombramientos`, ...), `topic` (el área de la Superintendencia), `summary` (en sus propias palabras), `issued_at`, `published_at`, `official_url` (el acto en el registro), `document_url`, `source_document_url` y `documents[]`. `document_url` es la copia de Croma del archivo principal del ítem, idéntica byte a byte a la que publicó la Superintendencia, que sigue disponible pase lo que pase con el enlace de la Superintendencia; `source_document_url` es el archivo en su propio sitio; `documents[]` lista cada archivo adjunto con su `name`, `format`, `document_url`, `source_document_url` y `bytes`.
## Un acto del registro
`POST /co/sic-normativa/regulation/v1` Dataset
| Campo | Tipo | Notas |
| --------------- | ------ | ------------------------------------------------------------------------------------------------ |
| `regulation_id` | string | **Obligatorio.** El `id` del acto que devuelve la búsqueda, p. ej. `24968`, o su `official_url`. |
```bash theme={"dark"}
curl https://api.croma.run/co/sic-normativa/regulation/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "regulation_id": "24968" }'
```
Devuelve `as_of`, `found`, `regulation_id` y `regulation`. Cada resultado incluye `id` (el número permanente del acto en el registro), `title`, `kinds[]` (como lo clasifica el registro: `Resoluciones`, `Circulares`, `Títulos Circular única`, `Leyes`, `Decretos`, `Doctrina`, `Nombramientos`, ...), `topic` (el área de la Superintendencia), `summary` (en sus propias palabras), `issued_at`, `published_at`, `official_url` (el acto en el registro), `document_url`, `source_document_url` y `documents[]`. `document_url` es la copia de Croma del archivo principal del ítem, idéntica byte a byte a la que publicó la Superintendencia, que sigue disponible pase lo que pase con el enlace de la Superintendencia; `source_document_url` es el archivo en su propio sitio; `documents[]` lista cada archivo adjunto con su `name`, `format`, `document_url`, `source_document_url` y `bytes`.
Un `id` que el sitio de la Superintendencia no tiene devuelve `found: false` con HTTP 200, no un error.
## Buscar en el Boletín Jurídico
`POST /co/sic-normativa/bulletins-search/v1` Dataset
Una sola búsqueda sobre cada ítem del Boletín Jurídico y sus conceptos, filtrada por sección, área o fecha de publicación.
| Campo | Tipo | Notas |
| ---------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Palabras opcionales que se buscan en el título, el resumen y las etiquetas. |
| `section` | enum | Sección opcional: `bulletin` (un ítem del Boletín) u `opinion` (un concepto). Por defecto `any`. |
| `topic` | string | Área opcional de la Superintendencia, p. ej. `Protección al Consumidor`, `Asuntos Jurisdiccionales`, `Propiedad Industrial`, comparada desde el inicio. No importan mayúsculas ni tildes. |
| `published_from` | string | Opcional: solo ítems publicados en esta fecha o después, `yyyy-mm-dd`. |
| `published_to` | string | Opcional: solo ítems publicados en esta fecha o antes, `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/sic-normativa/bulletins-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "retracto", "topic": "Protección al Consumidor" }'
```
Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, del publicado más recientemente al más antiguo. Cada resultado incluye `id`, `section` (`bulletin` u `opinion`), `title`, `topic` (el área de la Superintendencia), `tags[]`, `published_at`, `summary` (el resumen de la Superintendencia de la decisión o del concepto), `official_url` (el ítem en su sitio), `document_url`, `source_document_url` y `documents[]`. `document_url` es la copia de Croma del archivo principal del ítem, idéntica byte a byte a la que publicó la Superintendencia, que sigue disponible pase lo que pase con el enlace de la Superintendencia; `source_document_url` es el archivo en su propio sitio; `documents[]` lista cada archivo adjunto con su `name`, `format`, `document_url`, `source_document_url` y `bytes`.
## Un ítem del Boletín
`POST /co/sic-normativa/bulletin/v1` Dataset
| Campo | Tipo | Notas |
| ------------- | ------ | ------------------------------------------------------------------------------------------------ |
| `bulletin_id` | string | **Obligatorio.** El `id` del ítem que devuelve la búsqueda, p. ej. `24896`, o su `official_url`. |
```bash theme={"dark"}
curl https://api.croma.run/co/sic-normativa/bulletin/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "bulletin_id": "24896" }'
```
Devuelve `as_of`, `found`, `bulletin_id` y `bulletin`. Cada resultado incluye `id`, `section` (`bulletin` u `opinion`), `title`, `topic` (el área de la Superintendencia), `tags[]`, `published_at`, `summary` (el resumen de la Superintendencia de la decisión o del concepto), `official_url` (el ítem en su sitio), `document_url`, `source_document_url` y `documents[]`. `document_url` es la copia de Croma del archivo principal del ítem, idéntica byte a byte a la que publicó la Superintendencia, que sigue disponible pase lo que pase con el enlace de la Superintendencia; `source_document_url` es el archivo en su propio sitio; `documents[]` lista cada archivo adjunto con su `name`, `format`, `document_url`, `source_document_url` y `bytes`.
Un `id` que el sitio de la Superintendencia no tiene devuelve `found: false` con HTTP 200, no un error.
Esquemas, todos los campos de respuesta y un playground interactivo.