> ## 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
> Search the normative register and the Boletín Jurídico of Colombia's Superintendencia de Industria y Comercio: its resoluciones, circulares, the Circular Única, its doctrina and the decisions and concepts it highlights, with every original file; read any one.
The Superintendencia de Industria y Comercio (SIC) is Colombia's authority for consumer protection, personal data, industrial property, competition and technical regulations, and the country's largest consumer-law jurisdiction. Two of its publications are here. Its normative register holds about 7,600 acts: the laws and decrees it applies, its resoluciones and circulares, every título of the Circular Única as it is re-issued, the doctrina of its competition relatoría, its draft resolutions and its appointments, each with the dates it was issued and published, the Superintendencia's summary and every attached file. Its Boletín Jurídico holds about 750 items since 2019: the decisions and concepts the Oficina Asesora Jurídica chooses to highlight, by area, with a summary and the underlying document, plus the conceptos it publishes alongside.
Search either by kind, area, date or free text over the titles and summaries. New items appear the day after the Superintendencia publishes them.
The whole source, organized and ready to query: every endpoint on this page answers in milliseconds. Every response carries `as_of`: how current the data is. [How datasets work](/datasets).
## Search the register
`POST /co/sic-normativa/regulations-search/v1` Dataset
One search over every act in the Superintendencia's normative register, filtered by kind, area, date of issue or date of publication.
| Field | Type | Notes |
| ---------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Optional words matched against the title and the summary. |
| `kind` | string | Optional kind as the register files it, e.g. `Resoluciones`, `Circulares`, `Títulos Circular única`, `Leyes`, `Decretos`, `Doctrina`, `Nombramientos`, `Proyectos de resolución`. Case and accents are ignored. |
| `topic` | string | Optional area of the Superintendencia, e.g. `Protección al Consumidor`, `Protección de Datos Personales`, `Propiedad Industrial`, `Protección a la Competencia`, matched from the start. Case and accents are ignored. |
| `issued_from` | string | Optional: only acts issued on or after this date, `yyyy-mm-dd`. |
| `issued_to` | string | Optional: only acts issued on or before this date, `yyyy-mm-dd`. |
| `published_from` | string | Optional: only acts published on or after this date, `yyyy-mm-dd`. |
| `published_to` | string | Optional: only acts published on or before this date, `yyyy-mm-dd`. |
| `page` | integer | 1-based page number. Default `1`. |
| `per_page` | integer | Results per page (1-50). Default `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" }'
```
Returns `as_of` (how current the data is), the applied filters, `total` and `total_is_exact`, `page`, `per_page`, `total_pages`, `count` and `results[]`, most recently published first. Every result carries `id` (the act's permanent number in the register), `title`, `kinds[]` (as the register files it: `Resoluciones`, `Circulares`, `Títulos Circular única`, `Leyes`, `Decretos`, `Doctrina`, `Nombramientos`, ...), `topic` (the Superintendencia's area), `summary` (in its own words), `issued_at`, `published_at`, `official_url` (the act in the register), `document_url`, `source_document_url` and `documents[]`. `document_url` is Croma's copy of the item's main file, byte for byte as the Superintendencia published it, which stays available whatever happens to the Superintendencia's link; `source_document_url` is the file on its own site; `documents[]` lists every attached file with its `name`, `format`, `document_url`, `source_document_url` and `bytes`.
## One act of the register
`POST /co/sic-normativa/regulation/v1` Dataset
| Field | Type | Notes |
| --------------- | ------ | --------------------------------------------------------------------------------------- |
| `regulation_id` | string | **Required.** The act's `id` from a search result, e.g. `24968`, or its `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" }'
```
Returns `as_of`, `found`, `regulation_id` and `regulation`. Every result carries `id` (the act's permanent number in the register), `title`, `kinds[]` (as the register files it: `Resoluciones`, `Circulares`, `Títulos Circular única`, `Leyes`, `Decretos`, `Doctrina`, `Nombramientos`, ...), `topic` (the Superintendencia's area), `summary` (in its own words), `issued_at`, `published_at`, `official_url` (the act in the register), `document_url`, `source_document_url` and `documents[]`. `document_url` is Croma's copy of the item's main file, byte for byte as the Superintendencia published it, which stays available whatever happens to the Superintendencia's link; `source_document_url` is the file on its own site; `documents[]` lists every attached file with its `name`, `format`, `document_url`, `source_document_url` and `bytes`.
An `id` the Superintendencia's site does not hold returns `found: false` with HTTP 200, not an error.
## Search the Boletín Jurídico
`POST /co/sic-normativa/bulletins-search/v1` Dataset
One search over every item of the Boletín Jurídico and its conceptos, filtered by section, area or date of publication.
| Field | Type | Notes |
| ---------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Optional words matched against the title, the summary and the tags. |
| `section` | enum | Optional section: `bulletin` (an item of the Boletín) or `opinion` (a concepto). Default `any`. |
| `topic` | string | Optional area of the Superintendencia, e.g. `Protección al Consumidor`, `Asuntos Jurisdiccionales`, `Propiedad Industrial`, matched from the start. Case and accents are ignored. |
| `published_from` | string | Optional: only items published on or after this date, `yyyy-mm-dd`. |
| `published_to` | string | Optional: only items published on or before this date, `yyyy-mm-dd`. |
| `page` | integer | 1-based page number. Default `1`. |
| `per_page` | integer | Results per page (1-50). Default `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" }'
```
Returns `as_of` (how current the data is), the applied filters, `total` and `total_is_exact`, `page`, `per_page`, `total_pages`, `count` and `results[]`, most recently published first. Every result carries `id`, `section` (`bulletin` or `opinion`), `title`, `topic` (the Superintendencia's area), `tags[]`, `published_at`, `summary` (the Superintendencia's summary of the decision or concept), `official_url` (the item on its site), `document_url`, `source_document_url` and `documents[]`. `document_url` is Croma's copy of the item's main file, byte for byte as the Superintendencia published it, which stays available whatever happens to the Superintendencia's link; `source_document_url` is the file on its own site; `documents[]` lists every attached file with its `name`, `format`, `document_url`, `source_document_url` and `bytes`.
## One item of the Boletín
`POST /co/sic-normativa/bulletin/v1` Dataset
| Field | Type | Notes |
| ------------- | ------ | ---------------------------------------------------------------------------------------- |
| `bulletin_id` | string | **Required.** The item's `id` from a search result, e.g. `24896`, or its `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" }'
```
Returns `as_of`, `found`, `bulletin_id` and `bulletin`. Every result carries `id`, `section` (`bulletin` or `opinion`), `title`, `topic` (the Superintendencia's area), `tags[]`, `published_at`, `summary` (the Superintendencia's summary of the decision or concept), `official_url` (the item on its site), `document_url`, `source_document_url` and `documents[]`. `document_url` is Croma's copy of the item's main file, byte for byte as the Superintendencia published it, which stays available whatever happens to the Superintendencia's link; `source_document_url` is the file on its own site; `documents[]` lists every attached file with its `name`, `format`, `document_url`, `source_document_url` and `bytes`.
An `id` the Superintendencia's site does not hold returns `found: false` with HTTP 200, not an error.
Schemas, all response fields, and an interactive playground.