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

# Planalto (legislación federal)

> Busca en la legislación federal de Brasil tal como la publica la Presidência da República (la Constitución y sus enmiendas, y cada lei complementar, lei ordinária, lei delegada, decreto-lei, decreto y medida provisória), y lee el texto vigente de cualquier acto, completo o artículo por artículo, con los actos posteriores que lo modificaron.

La Presidência da República publica la legislación federal de Brasil en el
sitio del Planalto: cada acto tal como se firmó y, para los que se modificaron
después, un texto consolidado sin la redacción sustituida y con cada cambio
anotado donde se hizo. Aquí hay unos 55.000 actos, actualizados a diario: la
Constitución de 1988 y sus enmiendas, y cada lei complementar, lei ordinária,
lei delegada, decreto-lei, decreto y medida provisória desde el siglo XIX.

Busca por tipo, número, año, fecha o cualquier palabra del texto, y luego lee
un acto completo o un solo artículo. Cada acto viene con los actos posteriores
que sus notas registran como modificaciones, adiciones o derogaciones, artículo
por artículo, y la consulta lista a su vez los actos anteriores que modificó.
Una medida provisória trae además su situación: en trámite en el Congreso,
convertida en ley (y en cuál), vencida, rechazada o derogada.

<Note>
  La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
</Note>

## Buscar actos federales

`POST /br/planalto/laws-search/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

Encuentra actos por tipo, número, año, fecha o palabras del texto.

| Campo            | Tipo    | Notas                                                                                                                                                                                                            |
| ---------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`          | string  | Opcional. Palabras que se buscan en el nombre del acto, su ementa y su texto completo, p. ej. `usucapião extrajudicial`.                                                                                         |
| `type`           | enum    | Opcional. `constitution`, `constitutional_amendment`, `complementary_law`, `ordinary_law`, `delegated_law`, `decree_law`, `decree` o `provisional_measure`.                                                      |
| `measure_status` | enum    | Opcional. Solo medidas provisórias en esta situación: `pending`, `converted`, `lapsed`, `rejected`, `prejudiced` o `revoked`.                                                                                    |
| `number`         | string  | Opcional. El número del acto, con o sin punto de miles: `13105` y `13.105` son el mismo acto.                                                                                                                    |
| `year`           | integer | Opcional. El año en que se firmó el acto. Dos actos del mismo tipo pueden compartir número (las leis más antiguas se volvieron a numerar desde 1 en los años cuarenta), y el año los distingue. Por defecto `0`. |
| `from_date`      | string  | Opcional. Solo actos firmados en esta fecha o después, `yyyy-mm-dd`.                                                                                                                                             |
| `to_date`        | string  | Opcional. Solo actos firmados en esta fecha o antes, `yyyy-mm-dd`.                                                                                                                                               |
| `page`           | integer | Opcional. Página, desde 1. Por defecto `1`.                                                                                                                                                                      |
| `per_page`       | integer | Opcional. Resultados por página, 1-50. Por defecto `20`.                                                                                                                                                         |

```bash theme={"dark"}
curl https://api.croma.run/br/planalto/laws-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "ordinary_law", "number": "13105" }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` y `results[]`, del firmado más recientemente al más antiguo. Cada acto incluye `id`, `type` y `type_label` (el tipo, como lo nombra el derecho brasileño), `number`, `year`, `name` (su cita completa), `summary` (la ementa, lo que el propio acto dice que hace), `signed_on`, `published_on` (en el Diário Oficial da União), `revoked` y `revoked_by`, `amended_by[]` (los actos posteriores cuyos cambios registra su texto, cada uno con `law_id`, `name`, `changes[]` y los `articles[]` que tocó), `official_url`, `consolidated_url`, `veto_message_url` y, para una medida provisória, `measure_status` (`pending`, `converted`, `lapsed`, `rejected`, `prejudiced` o `revoked`), `measure_status_note` (la redacción de la Presidência) y `converted_into` (la ley en que se convirtió).

<Note>
  Los resultados no incluyen el texto: los códigos y la Constitución tienen
  cientos de miles de caracteres. `query` sí busca dentro de él, así que una
  frase de un artículo encuentra el acto. Para ir directo a un acto, filtra por
  `type` y `number`: una búsqueda por el nombre de un código también encuentra
  cada acto posterior que lo cita, del más reciente al más antiguo.
</Note>

## Un acto, completo

`POST /br/planalto/law/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

Devuelve un acto por su id, o uno de sus artículos.

| Campo     | Tipo    | Notas                                                                                                                                                                                                                                     |
| --------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `law_id`  | string  | **Obligatorio.** El `id` del acto, como lo devuelve la búsqueda, p. ej. `lei-13105-2015` para el Código de Processo Civil o `cf-1988` para la Constitución. El `law_id` dentro del `amended_by[]` de otro acto es el mismo identificador. |
| `article` | string  | Opcional. El número de un artículo, p. ej. `12`, `1.029` u `8-A`: `content` trae entonces solo ese artículo, hasta el siguiente artículo o título.                                                                                        |
| `offset`  | integer | Opcional. Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`.                                                                                                     |
| `limit`   | integer | Opcional. Cuántos caracteres devolver. La mayoría de los actos caben en una respuesta; la Constitución y los códigos no. Por defecto `200000`.                                                                                            |

```bash theme={"dark"}
curl https://api.croma.run/br/planalto/law/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "law_id": "lei-13105-2015", "article": "1.029" }'
```

Devuelve `as_of`, `found`, `law_id`, `article` y `article_found` (cuando se pidió un artículo) y `law`, que trae todo lo que devuelve la búsqueda más `amends[]` (los actos anteriores que este modificó, con los `articles[]` que tocó en cada uno) y `content`: una ventana sobre el texto, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada acto incluye `id`, `type` y `type_label` (el tipo, como lo nombra el derecho brasileño), `number`, `year`, `name` (su cita completa), `summary` (la ementa, lo que el propio acto dice que hace), `signed_on`, `published_on` (en el Diário Oficial da União), `revoked` y `revoked_by`, `amended_by[]` (los actos posteriores cuyos cambios registra su texto, cada uno con `law_id`, `name`, `changes[]` y los `articles[]` que tocó), `official_url`, `consolidated_url`, `veto_message_url` y, para una medida provisória, `measure_status` (`pending`, `converted`, `lapsed`, `rejected`, `prejudiced` o `revoked`), `measure_status_note` (la redacción de la Presidência) y `converted_into` (la ley en que se convirtió).

<Note>
  El texto es el acto tal como rige hoy: la redacción sustituida se omite y cada
  disposición modificada conserva su nota, p. ej. "(Redação dada pela Lei nº
  13.256, de 2016)". Es la consolidación de la Presidência; el texto oficial es
  el publicado en el Diário Oficial da União. Los actos más largos superan el
  millón de caracteres, así que envía `article` para un solo artículo, o lee el
  texto por rangos: pasa `next_offset` como `offset` hasta que `has_more` sea
  falso.
</Note>

<Note>
  El texto de un acto derogado es lo que sigue vigente de él, a menudo solo su
  título y la nota que lo derogó. El Código de Processo Civil de 1973, derogado
  en 2015, conserva solo los artículos sobre insolvencia que el nuevo código
  dejó en pie. La medida provisória es la excepción: cuando vence o se convierte
  en ley la Presidência la tacha entera, así que su texto se conserva tal como
  se expidió.
</Note>

<Note>
  Un id que Croma no tiene devuelve `found: false` con HTTP 200, no un error. Eso
  incluye un id del `amended_by[]` de otro acto que esta fuente no tiene: una
  edición anterior de una medida provisória de antes de 2001 (solo se conserva
  la última) o un decreto sin número.
</Note>

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