otro); more cities follow. Search by free text over the full text of each document, its label and the city’s description, the best match first, or by city, kind, number, year or date, and read any one with the link to its document.
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 regulations
POST /co/hacienda-municipal/regulations-search/v1 Dataset
One search over every act the covered cities list, filtered by city, kind, number, year or date.
as_of (how current the data is), the applied filters, total and total_is_exact, page, per_page, total_pages, count and results[], newest year first (best match first when query is set). Every result carries id, city (barranquilla, medellin, cali or bucaramanga), city_name, entity (the body that publishes it), kind (acuerdo, decreto, resolucion, circular or otro), number, year, issued_at (the date of the act, when the city’s label gives a full one), published_at (when the city put the document on its page, when the page says so), title (as the city labels it), summary (the city’s one-line description, when it gives one), section (the heading it sits under on the city’s page), official_url (the city’s listing page), document_name, document_format, document_bytes, document_url and source_document_url. document_url is Croma’s copy of the document, byte for byte as the city published it, which stays available whatever happens to the city’s link (null while the copy is still pending, and so are document_name and document_format for a city that names its files only in the document itself); source_document_url is the document on the city’s own site. viewer_url opens the document in Croma Viewer, a page for signed-in Croma users that shows the PDF with the cited passages highlighted: add &cite=<start>-<end> once per passage, up to 12 (null when Croma holds no PDF of it). When query is set, each result also carries matches[]: up to 3 articles of the document that answer the search, best first, each with article (its heading as the document has it, e.g. ARTÍCULO 5, or null in a document without articles), text (the article exactly as it reads in the document), start and end (where it sits in the document’s text), scanned and viewer_url (the document opened in Croma Viewer on that article, highlighted).
scanned: true means the city published that document as a scanned image and its text was recognized from it, which can introduce errors. Quote it, but check it against document_url before relying on the exact wording.One regulation, with its text
POST /co/hacienda-municipal/regulation/v1 Dataset
as_of, found, regulation_id and regulation. Every result carries id, city (barranquilla, medellin, cali or bucaramanga), city_name, entity (the body that publishes it), kind (acuerdo, decreto, resolucion, circular or otro), number, year, issued_at (the date of the act, when the city’s label gives a full one), published_at (when the city put the document on its page, when the page says so), title (as the city labels it), summary (the city’s one-line description, when it gives one), section (the heading it sits under on the city’s page), official_url (the city’s listing page), document_name, document_format, document_bytes, document_url and source_document_url. document_url is Croma’s copy of the document, byte for byte as the city published it, which stays available whatever happens to the city’s link (null while the copy is still pending, and so are document_name and document_format for a city that names its files only in the document itself); source_document_url is the document on the city’s own site. viewer_url opens the document in Croma Viewer, a page for signed-in Croma users that shows the PDF with the cited passages highlighted: add &cite=<start>-<end> once per passage, up to 12 (null when Croma holds no PDF of it).
The regulation also carries its document’s text, so nothing has to be downloaded:
content is null when the document has no text yet (a scan not read, a spreadsheet) or has no article of the name sent; articles lists the ones it has.An
id or link none of the cities’ pages carries returns found: false with HTTP 200, not an error.Full reference
Schemas, all response fields, and an interactive playground.