> ## 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 > Busca en cada acto regulatorio de la CREG, el regulador de energía y gas de Colombia: resoluciones, circulares, conceptos jurídicos, proyectos de resolución y autos desde 1994, con el texto completo, las notas de vigencia y todos los archivos originales; lee cualquiera completo. La Comisión de Regulación de Energía y Gas (CREG) regula los mercados de energía eléctrica, gas natural, GLP y combustibles líquidos de Colombia: las tarifas, el mercado mayorista, las reglas bajo las que operan las empresas de servicios públicos, los generadores, los comercializadores y los operadores de red. Aquí están sus actos regulatorios desde 1994: unas 7.300 resoluciones (de carácter general y de carácter particular, sobre una empresa o una tarifa), 2.500 circulares, 7.500 conceptos jurídicos, 1.000 proyectos de resolución en consulta pública y los autos que abren actuaciones administrativas. Cada acto llega con su número, sus fechas de expedición y de publicación en la web, su referencia del Diario Oficial, el resumen de la CREG, su texto completo, las notas de vigencia de la CREG sobre los actos posteriores que lo modificaron o derogaron, y una copia de cada archivo que la CREG publicó con él: el acto en PDF y Word, el documento técnico que lo sustenta, sus anexos. Busca en todos a la vez, por tipo, número, año o fecha de expedición, o con texto libre que llega hasta el cuerpo de cada acto. Los actos nuevos aparecen al día siguiente de que la CREG 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 actos `POST /co/creg/acts-search/v1` Dataset Una sola búsqueda sobre el texto completo de cada acto del registro, filtrada por tipo, número, año o fecha de expedición. | Campo | Tipo | Notas | | ------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `query` | string | Palabras opcionales que se buscan en el título, el número y el texto completo. | | `kind` | enum | Tipo opcional: `resolution`, `particular_resolution`, `draft_resolution`, `circular`, `legal_opinion` u `order`. Por defecto `any`. | | `number` | string | Número de acto opcional, p. ej. `101 128` o `131`. No importan los ceros a la izquierda ni el separador. Los números se repiten entre tipos y años, así que combínalo con `kind` o `year`. | | `year` | integer | Año opcional de la designación del acto. 0 busca en todos los años. Por defecto `0`. | | `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/creg/acts-search/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "fronteras comerciales", "kind": "resolution", "year": 2026 }' ``` 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 acto expedido más recientemente al más antiguo. Cada resultado incluye `id` (familia, número y año, p. ej. `resolucion_101-128_2026`), `kind` (`resolution`, `particular_resolution`, `draft_resolution`, `circular`, `legal_opinion` u `order`), `number` (tal como lo escribe la CREG, p. ej. `101 128`), `year`, `title` (qué hace el acto, en palabras de la CREG), `issued_at`, `published_at` (en el sitio de la CREG), `gazette` y `gazette_date` (la referencia del Diario Oficial), `text_status` (`ok` o `missing`), `amendments[]` (las notas de vigencia de la CREG sobre los actos posteriores que lo modificaron, adicionaron o derogaron, cada una con el `act_id` de ese acto), `official_url` (el acto en el sitio de la CREG), `document_url` (la copia de Croma del archivo principal del acto, idéntica byte a byte a la que publicó la CREG, que sigue disponible pase lo que pase con el enlace de la CREG), `source_document_url` (el archivo en el sitio de la CREG), `documents[]` (todos los archivos que la CREG publicó con el acto: el acto en PDF y Word, documentos técnicos, anexos) y `source_modified_at`. Los resultados de búsqueda no incluyen el texto; `query` sí busca dentro de él, así que una frase del cuerpo encuentra el acto. Para leer el texto usa el endpoint CREG Act. ## Un acto, completo `POST /co/creg/act/v1` Dataset | Campo | Tipo | Notas | | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------- | | `act_id` | string | **Obligatorio.** El `id` del acto que devuelve la búsqueda, p. ej. `resolucion_101-128_2026`, o su `official_url`. | | `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/creg/act/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "act_id": "resolucion_101-128_2026" }' ``` 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` (familia, número y año, p. ej. `resolucion_101-128_2026`), `kind` (`resolution`, `particular_resolution`, `draft_resolution`, `circular`, `legal_opinion` u `order`), `number` (tal como lo escribe la CREG, p. ej. `101 128`), `year`, `title` (qué hace el acto, en palabras de la CREG), `issued_at`, `published_at` (en el sitio de la CREG), `gazette` y `gazette_date` (la referencia del Diario Oficial), `text_status` (`ok` o `missing`), `amendments[]` (las notas de vigencia de la CREG sobre los actos posteriores que lo modificaron, adicionaron o derogaron, cada una con el `act_id` de ese acto), `official_url` (el acto en el sitio de la CREG), `document_url` (la copia de Croma del archivo principal del acto, idéntica byte a byte a la que publicó la CREG, que sigue disponible pase lo que pase con el enlace de la CREG), `source_document_url` (el archivo en el sitio de la CREG), `documents[]` (todos los archivos que la CREG publicó con el acto: el acto en PDF y Word, documentos técnicos, anexos) y `source_modified_at`. Un `id` que el registro de la CREG no tiene devuelve `found: false` con HTTP 200, no un error. Esquemas, todos los campos de respuesta y un playground interactivo.