# La legislación colombiana pasa al Gestor Normativo

**Publicado:** 16 de septiembre de 2026 | **Autores:** Cristian Correa

---

Desde hoy la legislación colombiana en Croma se consulta en el Gestor Normativo de Función Pública: más de 40.000 normas, de leyes y decretos a conceptos, sentencias y circulares, cada una con su texto consolidado, los temas bajo los que está clasificada y las normas que la adicionaron, modificaron o derogaron. Los dos endpoints de Legalize quedan deprecados hoy y dejan de responder el 30 de septiembre de 2026.

| Deprecado | Sucesor |
| --- | --- |
| `POST /co/legalize/laws/v1` | `POST /co/funcion-publica/norms-search/v1` |
| `POST /co/legalize/law/v1` | `POST /co/funcion-publica/norm/v1` |

## Por qué el cambio

Legalize es un servicio externo. No controlamos cómo actualiza sus datos, cuándo corrige un error ni cuánto tiempo sostiene su servicio, así que no podíamos respaldar esos endpoints con el mismo soporte que damos al resto de la API.

Por eso empezamos a mantener nuestra propia fuente de verdad para la legislación colombiana, una sobre la que sí tenemos control: el Gestor Normativo, completo, organizado y al día, con `as_of` en cada respuesta para saber hasta cuándo están actualizados los datos. Si algo falla, lo vemos y lo resolvemos nosotros, sin esperar a un tercero, y podemos responder por cada norma cuando nos escribes.

## Cómo migrar

La solicitud y la respuesta cambian, así que migrar es más que cambiar la ruta. Una ley se busca por tipo, número y año:

```bash
curl https://api.croma.run/co/funcion-publica/norms-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_type": "ley",
    "number": "1266",
    "year": 2008
  }'
```

El `id` de cada resultado (`34488` para la Ley 1266 de 2008) es el `norm_id` con el que se pide la norma completa:

```bash
curl https://api.croma.run/co/funcion-publica/norm/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "norm_id": "34488" }'
```

| Legalize | Gestor Normativo |
| --- | --- |
| `query` | `query`, sobre la cita, la descripción y el texto completo de la norma |
| `law_type` | `document_type`: `ley`, `decreto`, `concepto`, `sentencia`, `resolucion` y otros |
| `year` como texto (`"2008"`) | `year` como número (`2008`) |
| `per_page` hasta 100 | `per_page` hasta 50 |
| `status` y `jurisdiction` | Sin equivalente directo. `entity` filtra por la entidad que expide la norma y `amendments` lista las normas que la modificaron o derogaron |
| `law_id` (`LEY-1266-2008`) | `norm_id` (`34488`), el `id` que devuelve la búsqueda |
| `content_md` | `content.text`, por rangos: sigue `next_offset` hasta que `has_more` sea `false` |

## Qué pasa hasta el 30 de septiembre

- Los endpoints de Legalize siguen respondiendo igual. Cada respuesta lleva los encabezados `Deprecation` y `Sunset`, un `Link` con `rel="successor-version"` y un campo `deprecation` en el cuerpo.
- Legalize ya no aparece como herramienta en el servidor MCP ni en las herramientas del sitio. Los agentes conectados por MCP tienen `funcion_publica_norms_search` y `funcion_publica_norm`.
- Desde el 30 de septiembre de 2026 ambas rutas responden `410` con `code: "endpoint_retired"` y el mismo `Link` al sucesor.

La [política de versionado](https://docs.usecroma.com/es/versioning) da 90 días de aviso antes de retirar un endpoint. Estos dos tienen 14, y la política lo dice junto a la lista de endpoints deprecados.

La guía está en [Función Pública](https://docs.usecroma.com/es/guides/colombia/funcion-publica).

---

**Más novedades:** [Ver todas las entradas del changelog](/es/changelog/sitemap.md) | [Croma](https://usecroma.com)