> ## 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.
# CREG
> Busque em cada ato regulatório da CREG, o regulador de energia e gás da Colômbia: resoluções, circulares, conceitos jurídicos, projetos de resolução e autos desde 1994, com o texto integral, as notas de vigência e todos os arquivos originais; leia qualquer um completo.
A Comisión de Regulación de Energía y Gas (CREG) regula os mercados de energia elétrica, gás natural, GLP e combustíveis líquidos da Colômbia: as tarifas, o mercado atacadista, as regras sob as quais operam as empresas de serviços públicos, os geradores, os comercializadores e os operadores de rede. Aqui estão seus atos regulatórios desde 1994: cerca de 7.300 resoluções (de caráter geral e de caráter particular, sobre uma empresa ou uma tarifa), 2.500 circulares, 7.500 conceitos jurídicos, 1.000 projetos de resolução em consulta pública e os autos que abrem procedimentos administrativos. Cada ato chega com seu número, suas datas de expedição e de publicação na web, sua referência do Diario Oficial, o resumo da CREG, seu texto integral, as notas de vigência da CREG sobre os atos posteriores que o modificaram ou revogaram, e uma cópia de cada arquivo que a CREG publicou com ele: o ato em PDF e Word, o documento técnico que o sustenta, seus anexos.
Busque em todos de uma vez, por tipo, número, ano ou data de expedição, ou com texto livre que alcança o corpo de cada ato. Os atos novos aparecem no dia seguinte ao que a CREG os publica.
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).
## Buscar atos
`POST /co/creg/acts-search/v1` Dataset
Uma única busca sobre o texto integral de cada ato do registro, filtrada por tipo, número, ano ou data de expedição.
| Campo | Tipo | Notas |
| ------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Palavras opcionais buscadas no título, no número e no texto integral. |
| `kind` | enum | Tipo opcional: `resolution`, `particular_resolution`, `draft_resolution`, `circular`, `legal_opinion` ou `order`. Padrão `any`. Por padrão `any`. |
| `number` | string | Número de ato opcional, p. ex. `101 128` ou `131`. Zeros à esquerda e o separador não importam. Os números se repetem entre tipos e anos, então combine-o com `kind` ou `year`. |
| `year` | integer | Ano opcional da designação do ato. 0 busca em todos os anos. Por padrão `0`. |
| `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/creg/acts-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "fronteras comerciales", "kind": "resolution", "year": 2026 }'
```
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 ato expedido mais recentemente ao mais antigo. Cada resultado traz `id` (família, número e ano, p. ex. `resolucion_101-128_2026`), `kind` (`resolution`, `particular_resolution`, `draft_resolution`, `circular`, `legal_opinion` ou `order`), `number` (como a CREG o escreve, p. ex. `101 128`), `year`, `title` (o que o ato faz, nas palavras da CREG), `issued_at`, `published_at` (no site da CREG), `gazette` e `gazette_date` (a referência do Diario Oficial), `text_status` (`ok` ou `missing`), `amendments[]` (as notas de vigência da CREG sobre os atos posteriores que o modificaram, adicionaram ou revogaram, cada uma com o `act_id` desse ato), `official_url` (o ato no site da CREG), `document_url` (a cópia da Croma do arquivo principal do ato, idêntica byte a byte à que a CREG publicou, que continua disponível aconteça o que acontecer com o link da CREG), `source_document_url` (o arquivo no site da CREG), `documents[]` (todos os arquivos que a CREG publicou com o ato: o ato em PDF e Word, documentos técnicos, anexos) e `source_modified_at`.
Os resultados da busca não incluem o texto; `query` busca dentro dele, então uma frase do corpo encontra o ato. Para ler o texto use o endpoint CREG Act.
## Um ato, completo
`POST /co/creg/act/v1` Dataset
| Campo | Tipo | Notas |
| -------- | ------- | ------------------------------------------------------------------------------------------------------------------------ |
| `act_id` | string | **Obrigatório.** O `id` do ato retornado pela busca, p. ex. `resolucion_101-128_2026`, ou sua `official_url`. |
| `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/creg/act/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "act_id": "resolucion_101-128_2026" }'
```
Retorna `as_of`, `found`, `act_id` e `act`, que traz tudo o que a busca retorna mais `content`: uma janela sobre o texto completo do ato, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (família, número e ano, p. ex. `resolucion_101-128_2026`), `kind` (`resolution`, `particular_resolution`, `draft_resolution`, `circular`, `legal_opinion` ou `order`), `number` (como a CREG o escreve, p. ex. `101 128`), `year`, `title` (o que o ato faz, nas palavras da CREG), `issued_at`, `published_at` (no site da CREG), `gazette` e `gazette_date` (a referência do Diario Oficial), `text_status` (`ok` ou `missing`), `amendments[]` (as notas de vigência da CREG sobre os atos posteriores que o modificaram, adicionaram ou revogaram, cada uma com o `act_id` desse ato), `official_url` (o ato no site da CREG), `document_url` (a cópia da Croma do arquivo principal do ato, idêntica byte a byte à que a CREG publicou, que continua disponível aconteça o que acontecer com o link da CREG), `source_document_url` (o arquivo no site da CREG), `documents[]` (todos os arquivos que a CREG publicou com o ato: o ato em PDF e Word, documentos técnicos, anexos) e `source_modified_at`.
Um `id` que o registro da CREG não tem retorna `found: false` com HTTP 200, não um erro.
Esquemas, todos os campos de resposta e um playground interativo.