> ## 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 la legislación colombiana como datos estructurados y resuelve el texto completo de una ley por id.

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

```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 }'
```

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

```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" }'
```

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

<Note>
  Un id de ley que no coincide **no** es un `404`; es un `200` normal con
  `found: false`.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, campos de respuesta y un playground interactivo.
</Card>