The whole source, organized and ready to query: every endpoint on this page answers in milliseconds. Every response carries
as_of: how current the data is. How datasets work.Search the dictámenes
POST /cl/suseso/dictamenes-search/v1 Dataset
One search over every dictamen SUSESO publishes since 1971, filtered by number, year, date, topic or a related dictamen.
as_of (how current the data is), the applied filters, total and total_is_exact, page, per_page, total_pages, count and results[], most recent dictamen first. Every result carries id (SUSESO’s permanent id for the dictamen, e.g. 758965), number (as SUSESO publishes it, e.g. O-01-S-00582-2025 or 4268-1988), title, year, issued_date, recipient (who it is addressed to), summary (SUSESO’s summary, which most dictámenes before 2019 lack), topics, descriptors, legal_sources, departments (the SUSESO units that issued it), action, criterion and validity (when SUSESO states them), related_circulars_text and related_oficios_text (the circulars and oficios it agrees with, as written), other_fields (any other labelled field), related_dictamenes and related_circulars (each with its id, title and issued_date), related_legislation, attachments (each file with its title, name, content_type, bytes, document_url and source_document_url), official_url (the dictamen’s page at SUSESO), document_url (Croma’s byte-for-byte copy of that page), source_document_url and document_versions. Fields SUSESO does not state are null.
Search results leave out the text.
query still matches against it, so a phrase from the body finds the dictamen; read the text itself with the SUSESO Dictamen endpoint.SUSESO adds to a dictamen’s related dictámenes and circulars as new ones appear. Croma reads new dictámenes every day and every dictamen again once a month.
One dictamen, in full
POST /cl/suseso/dictamen/v1 Dataset
as_of, found, dictamen_id and dictamen, which carries everything the search returns plus content, a window onto the full text with text, offset, total_length, has_more and next_offset. Every result carries id (SUSESO’s permanent id for the dictamen, e.g. 758965), number (as SUSESO publishes it, e.g. O-01-S-00582-2025 or 4268-1988), title, year, issued_date, recipient (who it is addressed to), summary (SUSESO’s summary, which most dictámenes before 2019 lack), topics, descriptors, legal_sources, departments (the SUSESO units that issued it), action, criterion and validity (when SUSESO states them), related_circulars_text and related_oficios_text (the circulars and oficios it agrees with, as written), other_fields (any other labelled field), related_dictamenes and related_circulars (each with its id, title and issued_date), related_legislation, attachments (each file with its title, name, content_type, bytes, document_url and source_document_url), official_url (the dictamen’s page at SUSESO), document_url (Croma’s byte-for-byte copy of that page), source_document_url and document_versions. Fields SUSESO does not state are null.
Long dictámenes are read a range at a time: send
offset and limit, then pass the response’s next_offset back as offset until has_more is false.An id SUSESO has not published returns
found: false with HTTP 200, not an error.Full reference
Schemas, all response fields, and an interactive playground.