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:
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:
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
DeprecationySunset, unLinkconrel="successor-version"y un campodeprecationen 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_searchyfuncion_publica_norm. - Desde el 30 de septiembre de 2026 ambas rutas responden
410concode: "endpoint_retired"y el mismoLinkal sucesor.
La política de versionado 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.