> ## 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.

# Legalize

> Busca a legislação colombiana como dados estruturados e resolve o texto completo de uma lei por id.

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`.                                              |

```bash theme={"dark"}
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`. |

```bash theme={"dark"}
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`.

<Note>
  Um id de lei que não coincide **não** é um `404`; é um `200` normal com
  `found: false`.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, campos de resposta e um playground interativo.
</Card>