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

> Busque em cada ato administrativo e sentença da Superintendencia de Industria y Comercio da Colômbia desde 2014, cerca de 280.000, por identificação das partes, radicado, dependência, tipo, data ou texto integral; leia qualquer um completo com seu documento.

A Superintendencia de Industria y Comercio (SIC) mantém um registro dos atos que expede: cerca de 144.000 resoluções de suas investigações (proteção ao consumidor, dados pessoais e habeas data, usuários de telecomunicações, regulamentos técnicos e metrologia legal, câmaras de comércio, cobrança coativa) e cerca de 136.000 sentenças de sua delegatura para assuntos jurisdicionais, a maior jurisdição de direito do consumidor do país. Cada ato chega aqui com seu número, data e dependência, o radicado a que pertence, o que decidiu segundo a classificação da Superintendencia, suas partes com seu papel e identificação, seu texto integral e uma cópia de seu documento.

Busque pelo número de identificação de uma parte (um NIT ou uma cédula) para ver cada ato que a nomeia, ou por radicado, dependência, tipo, data ou texto livre sobre o corpo, as partes e as decisões. O registro carrega atos novos duas ou três vezes por mês, alguns com data de meses atrás; eles aparecem aqui no dia seguinte.

<Note>
  A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
</Note>

## Buscar atos

`POST /co/sic-actos/acts-search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Uma única busca sobre cada ato do registro, por identificação das partes, radicado, dependência, tipo, data ou texto livre.

| Campo                   | Tipo    | Notas                                                                                                                                    |
| ----------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `query`                 | string  | Palavras opcionais buscadas no texto integral, nos nomes das partes, nas decisões e na dependência.                                      |
| `type`                  | enum    | Tipo opcional: `resolution` ou `judgment`. Padrão `any`. Por padrão `any`.                                                               |
| `office`                | string  | Dependência opcional, p. ex. `Grupo de Trabajo de Defensa del Consumidor`, comparada desde o início. Maiúsculas e acentos são ignorados. |
| `case_number`           | string  | Radicado opcional, p. ex. `24-449511` ou `24 449511`.                                                                                    |
| `party_document_number` | string  | Número de identificação opcional (NIT ou cédula) de qualquer parte ou representante, só dígitos; os separadores são ignorados.           |
| `issued_from`           | string  | Opcional: só atos expedidos nesta data ou depois, `yyyy-mm-dd`.                                                                          |
| `issued_to`             | string  | Opcional: só atos expedidos nesta data ou antes, `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/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"
      }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`, do mais recente ao mais antigo. Cada resultado traz `id` (o número permanente do ato no registro), `act_id`, `type` (`resolution`, `judgment` ou `other`) e `type_label`, `number`, `issued_at`, `office` (a dependência que o expediu), `case_number` (o radicado, p. ex. `24-449511`), `decisions[]` (`class`, `name`, `act_type`: o que o ato decide, como a Superintendencia o classifica), `parties[]` (`name`, `role`, `document_type`, `document_number`, e do representante `representative_name`, `representative_document_type`, `representative_document_number`), `party_document_numbers[]`, `file_name`, `registered_at`, `modified_at`, `text_status` (`ok`, `scanned` ou `missing`), `document_url` (a cópia da Croma do PDF do ato, idêntica byte a byte à que a Superintendencia publicou), `source_document_url` (sempre null: a Superintendencia não oferece um link permanente ao documento) e `document_bytes`.

<Note>
  Os resultados da busca não incluem o texto; `query` busca dentro dele. Para ler o texto use o endpoint SIC Act.
</Note>

## Um ato, completo

`POST /co/sic-actos/act/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

| Campo    | Tipo    | Notas                                                                                                                    |
| -------- | ------- | ------------------------------------------------------------------------------------------------------------------------ |
| `act_id` | string  | **Obrigatório.** O `id` do ato retornado pela busca, p. ex. `2681688`.                                                   |
| `offset` | integer | Primeiro caractere do texto a retornar. Envie o `next_offset` da resposta anterior para continuar lendo. Por padrão `0`. |
| `limit`  | integer | Quantos caracteres do texto retornar. A maioria dos atos cabe em uma resposta. Por padrão `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" }'
```

Retorna `as_of`, `found`, `act_id` e `act`, que traz tudo o que a busca retorna mais `content`: uma janela sobre o texto integral do ato, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o número permanente do ato no registro), `act_id`, `type` (`resolution`, `judgment` ou `other`) e `type_label`, `number`, `issued_at`, `office` (a dependência que o expediu), `case_number` (o radicado, p. ex. `24-449511`), `decisions[]` (`class`, `name`, `act_type`: o que o ato decide, como a Superintendencia o classifica), `parties[]` (`name`, `role`, `document_type`, `document_number`, e do representante `representative_name`, `representative_document_type`, `representative_document_number`), `party_document_numbers[]`, `file_name`, `registered_at`, `modified_at`, `text_status` (`ok`, `scanned` ou `missing`), `document_url` (a cópia da Croma do PDF do ato, idêntica byte a byte à que a Superintendencia publicou), `source_document_url` (sempre null: a Superintendencia não oferece um link permanente ao documento) e `document_bytes`.

<Note>
  Um `id` que o registro não tem retorna `found: false` com HTTP 200, não um erro.
</Note>

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