Skip to main content
POST
Planalto Laws Search

Authorizations

Authorization
string
header
required

Use Authorization: Bearer YOUR_API_KEY

Headers

Idempotency-Key
string

Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.

Maximum string length: 255
Example:

"0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b"

Body

application/json
query
string
default:""

Términos de búsqueda en el nombre, la ementa y el texto completo del acto (opcional).

Maximum string length: 300
type
enum<string>
default:""

Tipo de acto: constitution (la Constitución de 1988), constitutional_amendment (enmiendas constitucionales, incluidas las de revisión), complementary_law, ordinary_law, delegated_law, decree_law, decree o provisional_measure (medida provisória) (opcional; por defecto todos).

Available options:
,
constitution,
constitutional_amendment,
complementary_law,
ordinary_law,
delegated_law,
decree_law,
decree,
provisional_measure
measure_status
enum<string>
default:""

Situación de una medida provisória: pending (en trámite), converted (convertida en ley), lapsed (vigencia terminada sin votación), rejected, prejudiced (prejudicada) o revoked (opcional).

Available options:
,
pending,
converted,
lapsed,
rejected,
prejudiced,
revoked
number
string
default:""

Número del acto, con o sin punto de miles, p. ej. 13105 o 13.105 (opcional). Coincidencia exacta.

Pattern: ^(?:\d[\d.]{0,9}(?:\s*-?\s*[A-Za-z0-9]{1,3})?)?$
year
integer
default:0

Año en que se firmó el acto, p. ej. 2015; 0 sin filtro (opcional). Distingue actos que comparten número.

Required range: 0 <= x <= 2100
from_date
string<date>
default:""

Optional date filter in yyyy-mm-dd format.

to_date
string<date>
default:""

Optional date filter in yyyy-mm-dd format.

page
integer
default:1

1-based page number for paginated results.

Required range: 1 <= x <= 1000
per_page
integer
default:20

Resultados por página (1-50).

Required range: 1 <= x <= 50

Response

Successful response

data
object
required