Skip to main content
POST
Contraloría Chile Dictámenes 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 dictamen's number, subject, descriptors, legal sources and full text, e.g. pensión de retiro or ley 18.834 feriado. Every word must appear; plural and singular match each other.

Maximum string length: 300
number
string
default:""

Optional dictamen number, with its letter prefix when it has one, e.g. 428, E152884, OF197180. Leading zeros, spaces and dots are ignored. Numbers restart every year: add year to name one dictamen.

Maximum string length: 20
year
integer
default:0

Optional year of the dictamen. 0 searches every year.

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.

criterion
enum<string>
default:""

Optional criterion: generates for dictámenes that set new jurisprudence (Genera Jurisprudencia), applies for those that apply existing jurisprudence (Aplica Jurisprudencia).

Available options:
,
generates,
applies
status
enum<string>
default:""

Optional status flag the dictamen carries today: new, applied, reconsidered, partially_reconsidered, clarified, altered, confirmed, complemented or reactivated. reconsidered finds dictámenes whose criterion a later one set aside.

Available options:
,
new,
applied,
reconsidered,
partially_reconsidered,
clarified,
altered,
confirmed,
complemented,
reactivated
references
string
default:""

Optional dictamen id, e.g. 022127N09: only the dictámenes that act on it (apply, reconsider, clarify, complement...).

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

Response

Successful response

data
object
required