> ## 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 Actos
> Busca en cada acto administrativo y sentencia de la Superintendencia de Industria y Comercio de Colombia desde 2014, unos 280.000, por identificación de las partes, radicado, dependencia, tipo, fecha o texto completo; lee cualquiera completo con su documento.
La Superintendencia de Industria y Comercio (SIC) lleva un registro de los actos que expide: unas 144.000 resoluciones de sus investigaciones (protección al consumidor, datos personales y habeas data, usuarios de telecomunicaciones, reglamentos técnicos y metrología legal, cámaras de comercio, cobro coactivo) y unas 136.000 sentencias de su delegatura para asuntos jurisdiccionales, la mayor jurisdicción de derecho del consumo del país. Cada acto llega aquí con su número, fecha y dependencia, el radicado al que pertenece, lo que decidió según la clasificación de la Superintendencia, sus partes con su rol e identificación, su texto completo y una copia de su documento.
Busca por el número de identificación de una parte (un NIT o una cédula) para ver cada acto que la nombra, o por radicado, dependencia, tipo, fecha o texto libre sobre el cuerpo, las partes y las decisiones. El registro carga actos nuevos dos o tres veces al mes, algunos con fecha de meses atrás; aparecen aquí al día siguiente.
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 actos
`POST /co/sic-actos/acts-search/v1` Dataset
Una sola búsqueda sobre cada acto del registro, por identificación de las partes, radicado, dependencia, tipo, fecha o texto libre.
| Campo | Tipo | Notas |
| ----------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Palabras opcionales que se buscan en el texto completo, los nombres de las partes, las decisiones y la dependencia. |
| `type` | enum | Tipo opcional: `resolution` o `judgment`. Por defecto `any`. |
| `office` | string | Dependencia opcional, p. ej. `Grupo de Trabajo de Defensa del Consumidor`, comparada desde el inicio. No importan mayúsculas ni tildes. |
| `case_number` | string | Radicado opcional, p. ej. `24-449511` o `24 449511`. |
| `party_document_number` | string | Número de identificación opcional (NIT o cédula) de cualquier parte o representante, solo dígitos; los separadores se ignoran. |
| `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`. |
| `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-actos/acts-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "habeas data",
"type": "resolution",
"issued_from": "2025-01-01"
}'
```
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 más reciente al más antiguo. Cada resultado incluye `id` (el número permanente del acto en el registro), `act_id`, `type` (`resolution`, `judgment` u `other`) y `type_label`, `number`, `issued_at`, `office` (la dependencia que lo expidió), `case_number` (el radicado, p. ej. `24-449511`), `decisions[]` (`class`, `name`, `act_type`: lo que decide el acto, como lo clasifica la Superintendencia), `parties[]` (`name`, `role`, `document_type`, `document_number`, y del representante `representative_name`, `representative_document_type`, `representative_document_number`), `party_document_numbers[]`, `file_name`, `registered_at`, `modified_at`, `text_status` (`ok`, `scanned` o `missing`), `document_url` (la copia de Croma del PDF del acto, idéntica byte a byte a la que publicó la Superintendencia), `source_document_url` (siempre null: la Superintendencia no ofrece un enlace permanente al documento) y `document_bytes`.
Los resultados de búsqueda no incluyen el texto; `query` sí busca dentro de él. Para leer el texto usa el endpoint SIC Act.
## Un acto, completo
`POST /co/sic-actos/act/v1` Dataset
| Campo | Tipo | Notas |
| -------- | ------- | --------------------------------------------------------------------------------------------------------------------------- |
| `act_id` | string | **Obligatorio.** El `id` del acto que devuelve la búsqueda, p. ej. `2681688`. |
| `offset` | integer | Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`. |
| `limit` | integer | Cuántos caracteres del texto devolver. La mayoría de los actos caben en una sola respuesta. Por defecto `200000`. |
```bash theme={"dark"}
curl https://api.croma.run/co/sic-actos/act/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "act_id": "2681688" }'
```
Devuelve `as_of`, `found`, `act_id` y `act`, que trae todo lo que devuelve la búsqueda más `content`: una ventana sobre el texto completo del acto, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id` (el número permanente del acto en el registro), `act_id`, `type` (`resolution`, `judgment` u `other`) y `type_label`, `number`, `issued_at`, `office` (la dependencia que lo expidió), `case_number` (el radicado, p. ej. `24-449511`), `decisions[]` (`class`, `name`, `act_type`: lo que decide el acto, como lo clasifica la Superintendencia), `parties[]` (`name`, `role`, `document_type`, `document_number`, y del representante `representative_name`, `representative_document_type`, `representative_document_number`), `party_document_numbers[]`, `file_name`, `registered_at`, `modified_at`, `text_status` (`ok`, `scanned` o `missing`), `document_url` (la copia de Croma del PDF del acto, idéntica byte a byte a la que publicó la Superintendencia), `source_document_url` (siempre null: la Superintendencia no ofrece un enlace permanente al documento) y `document_bytes`.
Un `id` que el registro no tiene devuelve `found: false` con HTTP 200, no un error.
Esquemas, todos los campos de respuesta y un playground interactivo.