Legalize

Legislación colombiana como datos estructurados, obtenida de Legalize. Dos consultas: buscar leyes por texto libre y filtros, o resolver el registro completo de una ley (metadatos más el texto de la ley en Markdown) por su identificador.

Búsqueda

POST /co/legalize/laws/v1

Campo	Tipo	Notas
`query`	string	Opcional. Búsqueda de texto libre sobre títulos y contenido de las leyes. Omítelo para listar todas.
`law_type`	string	Opcional. Filtra por tipo de norma, p. ej. `ley`, `decreto`.
`year`	string	Opcional. Año de publicación (`yyyy`).
`status`	string	Opcional. Filtra por estado, p. ej. `in_force`.
`jurisdiction`	string	Opcional. Filtra por jurisdicción.
`page`	integer	Número de página. Por defecto `1`.
`per_page`	integer	Resultados por página (1-100). Por defecto `50`.

curl https://api.croma.run/co/legalize/laws/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "habeas data", "per_page": 20 }'

Devuelve query, total (leyes que coinciden con los filtros), page, per_page, count (resultados en esta página) y results[]. Profundiza en una con la consulta por id de abajo.

`results[]`

Campo	Notas
`id`	Identificador de la ley. Pásalo a la consulta por id.
`title`	Título completo.
`short_title`	Título corto, o `null`.
`law_type`	Tipo, p. ej. `ley`, `decreto`.
`publication_date`	Fecha de publicación (`yyyy-mm-dd`).
`status`	Estado, p. ej. `in_force`.
`jurisdiction`	Jurisdicción, o `null`.
`article_count`	Número de artículos, o `null`.
`title_snippet`	Fragmento del título cuando la búsqueda coincide con él (puede incluir etiquetas `<mark>` de resaltado), o `null`.

Por id

POST /co/legalize/law/v1

Campo	Tipo	Notas
`law_id`	string	Obligatorio. El identificador de la ley devuelto por la búsqueda (`id`). Distingue mayúsculas, p. ej. `LEY-1266-2008`.

curl https://api.croma.run/co/legalize/law/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "law_id": "LEY-1266-2008" }'

Devuelve found, law_id y law. found es false (con law: null) cuando ninguna ley coincide con el identificador.

`law`

Campo	Notas
`id`, `title`, `short_title`	Identificador y títulos.
`law_type`	Tipo, p. ej. `ley`, `decreto`.
`publication_date`	Fecha de publicación (`yyyy-mm-dd`).
`status`	Estado, p. ej. `in_force`.
`jurisdiction`	Jurisdicción, o `null`.
`article_count`	Número de artículos, o `null`.
`department`	Departamento, o `null`.
`source`	Atribución de la fuente, o `null`.
`last_updated`	Última actualización, o `null`.
`content_md`	El texto completo de la ley en Markdown.

Las fechas son yyyy-mm-dd; los valores no disponibles son null.

Un id de ley que no coincide no es un 404; es un 200 normal con found: false.

Referencia completa

Esquemas, campos de respuesta y un playground interactivo.

Primeros pasos

Colombia

Perú

Global

Búsqueda

`results[]`

Por id

`law`

Referencia completa

​Búsqueda

​results[]

​Por id

​law

Referencia completa

Búsqueda

`results[]`

Por id

`law`