Legalize

Legislação colombiana como dados estruturados, obtida do Legalize. Duas consultas: buscar leis por texto livre e filtros, ou resolver o registro completo de uma lei (metadados mais o texto da lei em Markdown) pelo seu identificador.

Busca

POST /co/legalize/laws/v1

Campo	Tipo	Notas
`query`	string	Opcional. Busca de texto livre sobre títulos e conteúdo das leis. Omita-o para listar todas.
`law_type`	string	Opcional. Filtra por tipo de norma, p. ex. `ley`, `decreto`.
`year`	string	Opcional. Ano de publicação (`yyyy`).
`status`	string	Opcional. Filtra por estado, p. ex. `in_force`.
`jurisdiction`	string	Opcional. Filtra por jurisdição.
`page`	integer	Número de página. Por padrão `1`.
`per_page`	integer	Resultados por página (1-100). Por padrão `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 }'

Retorna query, total (leis que coincidem com os filtros), page, per_page, count (resultados nesta página) e results[]. Aprofunde em uma delas com a consulta por id abaixo.

`results[]`

Campo	Notas
`id`	Identificador da lei. Passe-o para a consulta por id.
`title`	Título completo.
`short_title`	Título curto, ou `null`.
`law_type`	Tipo, p. ex. `ley`, `decreto`.
`publication_date`	Data de publicação (`yyyy-mm-dd`).
`status`	Estado, p. ex. `in_force`.
`jurisdiction`	Jurisdição, ou `null`.
`article_count`	Número de artigos, ou `null`.
`title_snippet`	Fragmento do título quando a busca coincide com ele (pode incluir tags `<mark>` de destaque), ou `null`.

Por id

POST /co/legalize/law/v1

Campo	Tipo	Notas
`law_id`	string	Obrigatório. O identificador da lei retornado pela busca (`id`). Diferencia maiúsculas de minúsculas, p. ex. `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" }'

Retorna found, law_id e law. found é false (com law: null) quando nenhuma lei coincide com o identificador.

`law`

Campo	Notas
`id`, `title`, `short_title`	Identificador e títulos.
`law_type`	Tipo, p. ex. `ley`, `decreto`.
`publication_date`	Data de publicação (`yyyy-mm-dd`).
`status`	Estado, p. ex. `in_force`.
`jurisdiction`	Jurisdição, ou `null`.
`article_count`	Número de artigos, ou `null`.
`department`	Departamento, ou `null`.
`source`	Atribuição da fonte, ou `null`.
`last_updated`	Última atualização, ou `null`.
`content_md`	O texto completo da lei em Markdown.

As datas são yyyy-mm-dd; os valores não disponíveis são null.

Um id de lei que não coincide não é um 404; é um 200 normal com found: false.

Referência completa

Esquemas, campos de resposta e um playground interativo.

Primeiros passos

Países

Busca

`results[]`

Por id

`law`

Referência completa

​Busca

​results[]

​Por id

​law

Referência completa

Busca

`results[]`

Por id

`law`