Skip to main content
POST
Poder Judicial Labor Collection Courts Rulings 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:""

Optional words matched against the ruling's case number, case title, matters, descriptors and full text, e.g. prescripción adquisitiva or despido injustificado. Every word must appear; plural and singular match each other.

Maximum string length: 300
case_number
string
default:""

Optional case number (rol) with its year, as the court writes it, e.g. 13194-2026, or with its letter prefix in a first-instance court, e.g. C-4513-2026. Dots and spaces are ignored.

Maximum string length: 30
year
integer
default:0

Optional year of the case (the year in its rol, which can be earlier than the ruling). 0 searches every year.

Required range: 0 <= x <= 2100
matter
string
default:""

Optional matter, exactly as it appears in a result's matters, e.g. PATERNIDAD, RECONOCIMIENTO DE or HURTO SIMPLE POR UN VALOR DE MEDIA A MENOS DE 4 UTM..

Maximum string length: 200
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

Results per page (1-50).

Required range: 1 <= x <= 50
court
string
default:""

Optional court, by its exact name as it appears in a result's court, e.g. 27º Juzgado Civil de Santiago, Juzgado de Garantía de Curicó, Juzgado de Letras del Trabajo de Rancagua.

Maximum string length: 120

Response

Successful response

data
object
required