{"data":{"version":"1.0.0","status":"operational","authentication":"All POST endpoints require Authorization: Bearer YOUR_API_KEY. The /catalog and /openapi are public.","openapi_url":"https://api.croma.run/openapi","endpoints":[{"id":"rama-judicial-cases-by-entity","name":"Rama Judicial Cases by Entity","method":"POST","path":"/co/rama-judicial/cases-by-entity/v1","url":"https://api.croma.run/co/rama-judicial/cases-by-entity/v1","docs_url":"https://docs.usecroma.com/guides/colombia/rama-judicial","country":"Colombia","source":"Rama Judicial","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search Colombian judicial cases by entity name. Optional filters narrow by entity type, court code, recent activity, and page.","required":["name"],"request_schema":{"name":{"type":"string","minLength":3,"maxLength":200,"description":"Entity name to search for. Letters, digits, spaces, .,'&- allowed."},"entity_type":{"type":"string","enum":["natural","juridical"],"default":"natural","description":"Entity type: `natural` or `juridical`. Defaults to `natural`."},"active_only":{"type":"boolean","default":false,"description":"When true, only return cases with activity in the last 30 days."},"court_code":{"type":"string","default":"","description":"Optional court code to scope the search to one court."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"name":"RAPPI","entity_type":"juridical","active_only":true}},{"id":"rama-judicial-cases-by-radicado","name":"Rama Judicial Cases by Radicado","method":"POST","path":"/co/rama-judicial/cases-by-radicado/v1","url":"https://api.croma.run/co/rama-judicial/cases-by-radicado/v1","docs_url":"https://docs.usecroma.com/guides/colombia/rama-judicial","country":"Colombia","source":"Rama Judicial","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Resolve a Colombian judicial case by radicado and return case metadata plus the first 40 actuaciones (actions) available.","required":["registration_number"],"request_schema":{"registration_number":{"type":"string","minLength":20,"maxLength":25,"pattern":"^\\d{20,25}$","description":"The judicial case number (radicado), normally 23 digits, e.g. `11001600001720180327700`. 20-25 digits accepted."}},"example_request":{"registration_number":"11001600001720180327700"}},{"id":"rama-judicial-cases-by-radicado-batch","name":"Rama Judicial Cases by Radicado (Batch)","method":"POST","path":"/co/rama-judicial/cases-by-radicado/v1/batch","url":"https://api.croma.run/co/rama-judicial/cases-by-radicado/v1/batch","docs_url":"https://docs.usecroma.com/guides/colombia/rama-judicial","country":"Colombia","source":"Rama Judicial","rate_limit":"100 requests / 24h","served_from":"live","monitorable":false,"description":"Resolve up to 50 Colombian judicial cases by radicado in one request. Returns one result per radicado in input order, each with its own status, so a single bad radicado never fails the batch. Each item counts as one request against your quota.","required":["items"],"request_schema":{"items":{"type":"array","minItems":1,"maxItems":50,"description":"1-50 request objects, each identical to the single endpoint's body. Results are returned in the same order. Each item counts as one request against your quota.","items":{"type":"object","required":["registration_number"],"properties":{"registration_number":{"type":"string","minLength":20,"maxLength":25,"pattern":"^\\d{20,25}$","description":"The judicial case number (radicado), normally 23 digits, e.g. `11001600001720180327700`. 20-25 digits accepted."}},"additionalProperties":false}}},"example_request":{"items":[{"registration_number":"11001600001720180327700"},{"registration_number":"05001310300120190012300"}]}},{"id":"rama-judicial-emails-search","name":"Rama Judicial Emails Search","method":"POST","path":"/co/rama-judicial/emails-search/v1","url":"https://api.croma.run/co/rama-judicial/emails-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/rama-judicial","country":"Colombia","source":"Rama Judicial","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the Rama Judicial's official email directory: the mailbox of every Colombian despacho judicial and administrative area, with its corporation, specialty, department, city and seccional. Filter by place, kind of office or specialty (case and accents ignored), or resolve a court directly from a case: the first 12 digits of any radicado are the `court_code` of the despacho that holds it, and a full radicado is accepted as-is. Free text reaches the office name, the address itself, and the office's classification and place. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional search terms matched against the office name, the email address, and the office's corporation, specialty, department, city and seccional."},"department":{"type":"string","maxLength":60,"default":"","description":"Optional department, matched from the start of the name: `santander`, `bogota`, `valle`. Case and accents are ignored."},"city":{"type":"string","maxLength":60,"default":"","description":"Optional city, matched from the start of the name: `bogota` finds Bogotá D.C., `medellin` Medellín. Case and accents are ignored."},"corporation":{"type":"string","maxLength":120,"default":"","description":"Optional kind of office (corporación), matched from the start of the name: `juzgado-de-circuito`, `tribunal-superior`, `centro-de-servicios`, `corte-suprema`. Case and accents are ignored; `juzgado` matches every kind of juzgado."},"specialty":{"type":"string","maxLength":120,"default":"","description":"Optional specialty (especialidad), matched from the start of the name: `civil`, `laboral`, `penal` (which also matches the penal sub-specialties), `familia`. Case and accents are ignored."},"account_type":{"type":"string","enum":["","despacho","area"],"default":"","description":"Optional kind of mailbox: `despacho` for a court's own account, `area` for an administrative or service area. Empty returns both."},"court_code":{"type":"string","pattern":"^(\\d{12}|\\d{20,25})?$","default":"","description":"Optional 12-digit court code (código de despacho). A full 20-25-digit radicado is also accepted: its first 12 digits identify the office where the case is filed."},"district":{"type":"string","maxLength":60,"default":"","description":"Optional administrative district (seccional), matched from the start of the name: `bucaramanga` finds Seccional Bucaramanga, `nivel-central` the national level. Case and accents are ignored."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"city":"bucaramanga","specialty":"penal"}},{"id":"rama-judicial-emails-by-court","name":"Rama Judicial Emails by Court","method":"POST","path":"/co/rama-judicial/emails-by-court/v1","url":"https://api.croma.run/co/rama-judicial/emails-by-court/v1","docs_url":"https://docs.usecroma.com/guides/colombia/rama-judicial","country":"Colombia","source":"Rama Judicial","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve the official mailbox of a Colombian court from its 12-digit court code (código de despacho), or directly from a full radicado: its first 12 digits identify the court where the case is filed, so a case number answers \"whom do I email about this case\" in one call. Returns every account the directory holds for that code, the despacho's own mailbox first, then its service and filing areas. Served by Croma (`as_of` says how current the data is).","required":["court_code"],"request_schema":{"court_code":{"type":"string","pattern":"^(\\d{12}|\\d{20,25})$","description":"The court's 12-digit code (código de despacho), or a full 20-25-digit radicado: its first 12 digits identify the court where the case is filed."}},"example_request":{"court_code":"110013103021"}},{"id":"registraduria-vital-status","name":"Registraduría Vital Status","method":"POST","path":"/co/registraduria/vital-status/v1","url":"https://api.croma.run/co/registraduria/vital-status/v1","docs_url":"https://docs.usecroma.com/guides/colombia/registraduria","country":"Colombia","source":"Registraduría","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Check a Colombian cédula's vital status. Returns `found: false` if the cédula isn't in the registry; otherwise `status` is `ALIVE` or `DECEASED`.","required":["document_number"],"request_schema":{"document_number":{"type":"string","minLength":5,"maxLength":12,"pattern":"^[1-9]\\d{4,11}$","description":"Colombian cédula. 5-12 digits, no leading zero."}},"example_request":{"document_number":"5786287"}},{"id":"registro-civil-birth-record","name":"Registro Civil Birth Record","method":"POST","path":"/co/registro-civil/birth-record/v1","url":"https://api.croma.run/co/registro-civil/birth-record/v1","docs_url":"https://docs.usecroma.com/guides/colombia/registro-civil","country":"Colombia","source":"Registraduría Nacional del Estado Civil","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Find a Colombian birth civil registry (office, serial, inscription date) by first surname, first name, sex and date of birth. Returns `found: false` when there is no match.","required":["first_surname","first_name","sex","birth_date"],"request_schema":{"first_surname":{"type":"string","minLength":1,"maxLength":60,"description":"First surname (primer apellido)."},"first_name":{"type":"string","minLength":1,"maxLength":60,"description":"First given name (primer nombre)."},"sex":{"type":"string","enum":["M","F"],"description":"Sex on the record: `M` (masculino) or `F` (femenino)."},"birth_date":{"type":"string","format":"date","description":"Date of birth in yyyy-mm-dd format (year 1900 or later)."},"second_surname":{"type":"string","maxLength":60,"default":"","description":"Second surname (segundo apellido). Optional."},"second_name":{"type":"string","maxLength":60,"default":"","description":"Second given name (segundo nombre). Optional."}},"example_request":{"first_surname":"PEREZ","first_name":"JUAN","sex":"M","birth_date":"1990-01-01"}},{"id":"ruaf-affiliations","name":"RUAF Affiliations","method":"POST","path":"/co/ruaf/affiliations/v1","url":"https://api.croma.run/co/ruaf/affiliations/v1","docs_url":"https://docs.usecroma.com/guides/colombia/ruaf","country":"Colombia","source":"RUAF","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up a person's social-security affiliations in Colombia by document number. Requires the date the document was issued. `document_type` defaults to `CC`.","required":["document_number","issue_date"],"request_schema":{"document_type":{"type":"string","enum":["CC","CE","TI","RC","PA","PEP","PPT"],"default":"CC","description":"Colombian document type. Defaults to `CC`."},"document_number":{"type":"string","minLength":5,"maxLength":12,"pattern":"^[1-9]\\d{4,11}$","description":"Colombian cédula. 5-12 digits, no leading zero."},"issue_date":{"type":"string","format":"date","description":"Date the document was issued, in yyyy-mm-dd format. For TI and RC, the date of birth."}},"example_request":{"document_number":"1234567890","issue_date":"2008-02-15"}},{"id":"rues-entities-by-name","name":"RUES Entities by Name","method":"POST","path":"/co/rues/entities-by-name/v1","url":"https://api.croma.run/co/rues/entities-by-name/v1","docs_url":"https://docs.usecroma.com/guides/colombia/rues","country":"Colombia","source":"RUES","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search Colombian businesses in RUES by name, paginated, each result enriched with its full registry record.","required":["name"],"request_schema":{"name":{"type":"string","minLength":3,"maxLength":200,"description":"Entity name (razón social) to search for."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"name":"exito"}},{"id":"rues-entity-by-nit","name":"RUES Entity by NIT","method":"POST","path":"/co/rues/entity-by-nit/v1","url":"https://api.croma.run/co/rues/entity-by-nit/v1","docs_url":"https://docs.usecroma.com/guides/colombia/rues","country":"Colombia","source":"RUES","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Resolve a Colombian business by NIT and return its full RUES record: registry detail, financial statements, renewal history, related parties and registry notices.","required":["document_number"],"request_schema":{"document_number":{"type":"string","minLength":4,"maxLength":15,"pattern":"^\\d{4,15}$","description":"Colombian NIT (numeric, no verification digit). 4-15 digits."}},"example_request":{"document_number":"900654922"}},{"id":"policia-criminal-records","name":"Policía Criminal Records","method":"POST","path":"/co/policia/criminal-records/v1","url":"https://api.croma.run/co/policia/criminal-records/v1","docs_url":"https://docs.usecroma.com/guides/colombia/policia","country":"Colombia","source":"Policía Nacional","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Check a person's Colombian criminal record (antecedentes). `document_type` defaults to `CC`.","required":["document_number"],"request_schema":{"document_type":{"type":"string","enum":["CC","CE","PA","DPO"],"default":"CC","description":"Colombian document type. Defaults to `CC`."},"document_number":{"type":"string","minLength":3,"maxLength":30,"description":"Document number. Digits only for CC; letters, digits and hyphens for CE, PA and DPO."}},"example_request":{"document_number":"1234567890"}},{"id":"siata-conditions","name":"SIATA Aburrá Valley Conditions","method":"POST","path":"/co/siata/v1","url":"https://api.croma.run/co/siata/v1","docs_url":"https://docs.usecroma.com/guides/colombia/siata","country":"Colombia","source":"SIATA","rate_limit":"100 requests / 24h","served_from":"live","monitorable":false,"description":"Live environmental conditions for the Aburrá Valley (Medellín metropolitan area) from SIATA: per-station weather (temperature, humidity, wind, pressure), rainfall (accumulated + intensity), and air quality (24h PM2.5 + ICA index). All inputs optional: an empty body returns every station; pass `latitude` + `longitude` (with optional `radius_km`, default 10) to get only nearby stations, nearest first with `distance_km` populated. Coverage is the Medellín metro area only.","required":[],"request_schema":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Optional latitude. With `longitude`, returns only stations near that point."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Optional longitude. With `latitude`, returns only stations near that point."},"radius_km":{"type":"number","minimum":1,"maximum":100,"default":10,"description":"Radius in km around `latitude`/`longitude` to include stations. Defaults to 10."}},"example_request":{"latitude":6.2442,"longitude":-75.5812,"radius_km":5},"deprecated":{"since":"2026-08-27","sunset":"2026-12-01","successor_url":"https://api.croma.run/co/siata-geoportal/weather/v1"}},{"id":"siata-geoportal-weather","name":"SIATA Weather","method":"POST","path":"/co/siata-geoportal/weather/v1","url":"https://api.croma.run/co/siata-geoportal/weather/v1","docs_url":"https://docs.usecroma.com/guides/colombia/siata-geoportal","country":"Colombia","source":"SIATA","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Current weather at every SIATA station in the Aburrá Valley (Medellín metropolitan area): temperature, humidity, wind, pressure, an hourly 12-hour series per station, and the valley's UV index with today's hourly series. All inputs optional: an empty body returns every station; pass `latitude` + `longitude` (with optional `radius_km`, default 10) for nearby stations nearest first, or `municipality` / `station_code` to narrow. Coverage is the Medellín metro area only.","required":[],"request_schema":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Optional latitude. With `longitude`, returns only stations near that point."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Optional longitude. With `latitude`, returns only stations near that point."},"radius_km":{"type":"number","minimum":1,"maximum":100,"default":10,"description":"Radius in km around `latitude`/`longitude` to include stations. Defaults to 10."},"municipality":{"type":"string","maxLength":80,"default":"","description":"Optional municipality filter, e.g. `Medellín` or `Itagüí`. Accents and case are ignored."},"station_code":{"type":"string","maxLength":20,"default":"","description":"Optional station code, e.g. `520`. Returns only that station."}},"example_request":{"latitude":6.2442,"longitude":-75.5812,"radius_km":5}},{"id":"siata-geoportal-weather-series","name":"SIATA Weather Station Series","method":"POST","path":"/co/siata-geoportal/weather-series/v1","url":"https://api.croma.run/co/siata-geoportal/weather-series/v1","docs_url":"https://docs.usecroma.com/guides/colombia/siata-geoportal","country":"Colombia","source":"SIATA","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Minute-by-minute weather at one SIATA station in the Aburrá Valley (Medellín metropolitan area): temperature, humidity, wind speed and pressure over the last hour at one-minute resolution (`window: \"1h\"`, the default) or the last six hours at five-minute resolution (`window: \"6h\"`), with the source's means and temperature percentiles. `station_code` is required; codes come from the weather endpoint. Returns `found: false` for an unknown station.","required":["station_code"],"request_schema":{"station_code":{"type":"string","pattern":"^[0-9]{1,6}$","description":"Station code, e.g. `202`. Codes come from the `weather` endpoint's `station_code`."},"window":{"type":"string","enum":["1h","6h"],"default":"1h","description":"`1h` for the last hour at one-minute resolution, `6h` for the last six hours at five-minute resolution."}},"example_request":{"station_code":"202","window":"1h"}},{"id":"siata-geoportal-river-levels","name":"SIATA River Levels","method":"POST","path":"/co/siata-geoportal/river-levels/v1","url":"https://api.croma.run/co/siata-geoportal/river-levels/v1","docs_url":"https://docs.usecroma.com/guides/colombia/siata-geoportal","country":"Colombia","source":"SIATA","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Current river, stream and storm-sewer water levels for the Aburrá Valley (Medellín metropolitan area) from SIATA: per-station level in metres against the station's flood thresholds (with a derived status), the highest and mean level over the last three hours, the source's alert colour and level, six trailing windows, basin morphology and land cover. `include_series` adds a per-minute 3-hour series. All inputs optional: an empty body returns every station; pass `latitude` + `longitude` (with optional `radius_km`, default 10) for nearby stations nearest first, or `municipality` / `station_code` to narrow. Coverage is the Medellín metro area only.","required":[],"request_schema":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Optional latitude. With `longitude`, returns only stations near that point."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Optional longitude. With `latitude`, returns only stations near that point."},"radius_km":{"type":"number","minimum":1,"maximum":100,"default":10,"description":"Radius in km around `latitude`/`longitude` to include stations. Defaults to 10."},"municipality":{"type":"string","maxLength":80,"default":"","description":"Optional municipality filter, e.g. `Medellín` or `Itagüí`. Accents and case are ignored."},"station_code":{"type":"string","maxLength":20,"default":"","description":"Optional station code, e.g. `520`. Returns only that station."},"include_series":{"type":"boolean","default":false,"description":"When true, each station also carries `series_3h`, one level reading per minute for the last three hours."}},"example_request":{"latitude":6.2442,"longitude":-75.5812,"radius_km":5}},{"id":"siata-geoportal-rainfall","name":"SIATA Rainfall","method":"POST","path":"/co/siata-geoportal/rainfall/v1","url":"https://api.croma.run/co/siata-geoportal/rainfall/v1","docs_url":"https://docs.usecroma.com/guides/colombia/siata-geoportal","country":"Colombia","source":"SIATA","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Rain at every SIATA gauge in the Aburrá Valley (Medellín metropolitan area): whether it is raining now and the source's extreme-rain flag, rain accumulated over seven trailing windows (5 minutes to 30 days), and monthly totals for the current year with each month's data availability. All inputs optional: an empty body returns every gauge; pass `latitude` + `longitude` (with optional `radius_km`, default 10) for nearby gauges nearest first, or `municipality` / `station_code` to narrow. Coverage is the Medellín metro area only.","required":[],"request_schema":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Optional latitude. With `longitude`, returns only stations near that point."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Optional longitude. With `latitude`, returns only stations near that point."},"radius_km":{"type":"number","minimum":1,"maximum":100,"default":10,"description":"Radius in km around `latitude`/`longitude` to include stations. Defaults to 10."},"municipality":{"type":"string","maxLength":80,"default":"","description":"Optional municipality filter, e.g. `Medellín` or `Itagüí`. Accents and case are ignored."},"station_code":{"type":"string","maxLength":20,"default":"","description":"Optional station code, e.g. `520`. Returns only that station."}},"example_request":{"latitude":6.2442,"longitude":-75.5812,"radius_km":5}},{"id":"siata-geoportal-air-quality","name":"SIATA Air Quality","method":"POST","path":"/co/siata-geoportal/air-quality/v1","url":"https://api.croma.run/co/siata-geoportal/air-quality/v1","docs_url":"https://docs.usecroma.com/guides/colombia/siata-geoportal","country":"Colombia","source":"SIATA","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Current air quality at SIATA's reference stations in the Aburrá Valley (Medellín metropolitan area): 24-hour PM2.5 and PM10, 8-hour ozone and CO, 1-hour NO2 and SO2, each as a concentration with Colombia's numeric air-quality index (ICA) and its category, plus the pollutant driving each station's index. All inputs optional: an empty body returns every station; pass `latitude` + `longitude` (with optional `radius_km`, default 10) for nearby stations nearest first, or `municipality` / `station_code` to narrow. Coverage is the Medellín metro area only.","required":[],"request_schema":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Optional latitude. With `longitude`, returns only stations near that point."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Optional longitude. With `latitude`, returns only stations near that point."},"radius_km":{"type":"number","minimum":1,"maximum":100,"default":10,"description":"Radius in km around `latitude`/`longitude` to include stations. Defaults to 10."},"municipality":{"type":"string","maxLength":80,"default":"","description":"Optional municipality filter, e.g. `Medellín` or `Itagüí`. Accents and case are ignored."},"station_code":{"type":"string","maxLength":20,"default":"","description":"Optional station code, e.g. `520`. Returns only that station."}},"example_request":{"municipality":"Medellín"}},{"id":"siata-geoportal-citizen-sensors","name":"SIATA Citizen Air Sensors","method":"POST","path":"/co/siata-geoportal/citizen-sensors/v1","url":"https://api.croma.run/co/siata-geoportal/citizen-sensors/v1","docs_url":"https://docs.usecroma.com/guides/colombia/siata-geoportal","country":"Colombia","source":"SIATA","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"The citizen-science PM2.5 sensor network of the Aburrá Valley (Medellín metropolitan area), about 230 low-cost sensors: PM2.5 over the last hour, the daily air-quality index (ICA) with its category, whether each sensor is reporting, and its data recovery over 24 hours and 15 days. All inputs optional: an empty body returns every sensor; pass `latitude` + `longitude` (with optional `radius_km`, default 10) for nearby sensors nearest first, or `municipality` / `station_code` to narrow. Indicative data; use the air-quality endpoint for the reference network.","required":[],"request_schema":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Optional latitude. With `longitude`, returns only stations near that point."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Optional longitude. With `latitude`, returns only stations near that point."},"radius_km":{"type":"number","minimum":1,"maximum":100,"default":10,"description":"Radius in km around `latitude`/`longitude` to include stations. Defaults to 10."},"municipality":{"type":"string","maxLength":80,"default":"","description":"Optional municipality filter, e.g. `Medellín` or `Itagüí`. Accents and case are ignored."},"station_code":{"type":"string","maxLength":20,"default":"","description":"Optional station code, e.g. `520`. Returns only that station."}},"example_request":{"latitude":6.2442,"longitude":-75.5812,"radius_km":3}},{"id":"siata-geoportal-forecast","name":"SIATA Weather Forecast","method":"POST","path":"/co/siata-geoportal/forecast/v1","url":"https://api.croma.run/co/siata-geoportal/forecast/v1","docs_url":"https://docs.usecroma.com/guides/colombia/siata-geoportal","country":"Colombia","source":"SIATA","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"SIATA's two-day weather forecast for the Aburrá Valley (Medellín metropolitan area), per municipality and, for Medellín, per zone: daily maximum and minimum temperature and the likelihood of rain for each part of the day (early morning, morning, afternoon, night). Pass `municipality` to get one municipality; an empty body returns every zone. Issued once a day.","required":[],"request_schema":{"municipality":{"type":"string","maxLength":80,"default":"","description":"Optional municipality filter, e.g. `Medellín` or `Itagüí`. Accents and case are ignored."}},"example_request":{"municipality":"Medellín"}},{"id":"siata-geoportal-alerts","name":"SIATA Alerts","method":"POST","path":"/co/siata-geoportal/alerts/v1","url":"https://api.croma.run/co/siata-geoportal/alerts/v1","docs_url":"https://docs.usecroma.com/guides/colombia/siata-geoportal","country":"Colombia","source":"SIATA","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Official notices from SIATA, the early-warning system of the Aburrá Valley (Medellín metropolitan area): title, plain-text description, validity dates and audience. Returns the active notices; pass `include_past: true` for every notice on record, most recent first.","required":[],"request_schema":{"include_past":{"type":"boolean","default":false,"description":"When true, returns past notices as well as the active ones."}},"example_request":{"include_past":true}},{"id":"siata-geoportal-seismic-events","name":"SIATA Seismic Events","method":"POST","path":"/co/siata-geoportal/seismic-events/v1","url":"https://api.croma.run/co/siata-geoportal/seismic-events/v1","docs_url":"https://docs.usecroma.com/guides/colombia/siata-geoportal","country":"Colombia","source":"SIATA","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"The last earthquakes recorded by SIATA's accelerograph and seismograph network in the Aburrá Valley (Medellín metropolitan area): per station, the most recent events with magnitude, epicentre, depth and what the station measured (peak ground acceleration and Mercalli intensity on accelerographs, peak ground velocity on seismographs). All inputs optional: an empty body returns every station; pass `latitude` + `longitude` (with optional `radius_km`, default 10) for nearby stations nearest first, or `municipality` / `station_code` to narrow.","required":[],"request_schema":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Optional latitude. With `longitude`, returns only stations near that point."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Optional longitude. With `latitude`, returns only stations near that point."},"radius_km":{"type":"number","minimum":1,"maximum":100,"default":10,"description":"Radius in km around `latitude`/`longitude` to include stations. Defaults to 10."},"municipality":{"type":"string","maxLength":80,"default":"","description":"Optional municipality filter, e.g. `Medellín` or `Itagüí`. Accents and case are ignored."},"station_code":{"type":"string","maxLength":20,"default":"","description":"Optional station code, e.g. `520`. Returns only that station."}},"example_request":{}},{"id":"siata-geoportal-cameras","name":"SIATA Cameras","method":"POST","path":"/co/siata-geoportal/cameras/v1","url":"https://api.croma.run/co/siata-geoportal/cameras/v1","docs_url":"https://docs.usecroma.com/guides/colombia/siata-geoportal","country":"Colombia","source":"SIATA","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"SIATA's camera network in the Aburrá Valley (Medellín metropolitan area), about 90 cameras pointed at river gauges, the sky, underpasses and the boundary layer, each with the URL of its latest snapshot. All inputs optional: pass `latitude` + `longitude` (with optional `radius_km`, default 10) for nearby cameras nearest first, or `type` (`nivel`, `cielo`, `deprimido`, `capa_limite`) to keep one kind.","required":[],"request_schema":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Optional latitude. With `longitude`, returns only stations near that point."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Optional longitude. With `latitude`, returns only stations near that point."},"radius_km":{"type":"number","minimum":1,"maximum":100,"default":10,"description":"Radius in km around `latitude`/`longitude` to include stations. Defaults to 10."},"type":{"type":"string","maxLength":20,"default":"","description":"Optional camera type: `nivel` (river gauges), `cielo` (sky), `deprimido` (underpasses) or `capa_limite` (boundary layer)."}},"example_request":{"type":"nivel","latitude":6.2442,"longitude":-75.5812,"radius_km":5}},{"id":"legalize-laws-search","name":"Colombia Laws Search","method":"POST","path":"/co/legalize/laws/v1","url":"https://api.croma.run/co/legalize/laws/v1","docs_url":"https://docs.usecroma.com/guides/colombia/legalize","country":"Colombia","source":"Legalize","rate_limit":"100 requests / 24h","served_from":"live","monitorable":false,"description":"Search Colombian legislation as structured data, sourced from Legalize. Filter by free text, law type, publication year, status, and jurisdiction. Returns paginated law summaries; use `per_page` and `page` to page. Drill into one with `legalize-law-detail`.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Free-text search over law titles and content. Omit to list all."},"law_type":{"type":"string","maxLength":60,"default":"","description":"Filter by law type (e.g. `ley`, `decreto`). Omit for all types."},"year":{"type":"string","default":"","description":"Filter by publication year (yyyy). Omit for all years."},"status":{"type":"string","maxLength":40,"default":"","description":"Filter by law status (e.g. `in_force`). Omit for any status."},"jurisdiction":{"type":"string","maxLength":60,"default":"","description":"Filter by jurisdiction. Omit for all jurisdictions."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Results per page (1-100)."}},"example_request":{"query":"habeas data","per_page":20},"deprecated":{"since":"2026-09-16","sunset":"2026-09-30","successor_url":"https://api.croma.run/co/funcion-publica/norms-search/v1"}},{"id":"legalize-law-detail","name":"Colombia Law Detail","method":"POST","path":"/co/legalize/law/v1","url":"https://api.croma.run/co/legalize/law/v1","docs_url":"https://docs.usecroma.com/guides/colombia/legalize","country":"Colombia","source":"Legalize","rate_limit":"100 requests / 24h","served_from":"live","monitorable":false,"description":"Resolve a single Colombian law by its identifier and return the full record, sourced from Legalize: metadata plus the law text as Markdown (`content_md`). `found: false` when no law matches the identifier.","required":["law_id"],"request_schema":{"law_id":{"type":"string","minLength":1,"maxLength":200,"description":"The law identifier returned by the laws search (`id`)."}},"example_request":{"law_id":"LEY-1266-2008"},"deprecated":{"since":"2026-09-16","sunset":"2026-09-30","successor_url":"https://api.croma.run/co/funcion-publica/norm/v1"}},{"id":"ancp-cce-conceptos-search","name":"ANCP-CCE Conceptos Search","method":"POST","path":"/co/ancp-cce/conceptos-search/v1","url":"https://api.croma.run/co/ancp-cce/conceptos-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/ancp-cce","country":"Colombia","source":"Relatoría de la ANCP-CCE","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search conceptos (public-procurement legal opinions) from the Relatoría de la ANCP-CCE (Colombia Compra Eficiente) by free text, tema (descriptor), and modification date. Paginated, newest-modified first. Drill into one with `ancp-cce-concepto` for the full text.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional free-text search over the concepto text. Empty returns the most recently modified conceptos."},"subject":{"type":"string","maxLength":120,"default":"","description":"Optional tema (descriptor) filter, e.g. `Capacidad jurídica`. Empty applies no tema filter."},"modified_after":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (maximum 100)."}},"example_request":{"query":"capacidad jurídica"}},{"id":"ancp-cce-concepto","name":"ANCP-CCE Concepto","method":"POST","path":"/co/ancp-cce/concepto/v1","url":"https://api.croma.run/co/ancp-cce/concepto/v1","docs_url":"https://docs.usecroma.com/guides/colombia/ancp-cce","country":"Colombia","source":"Relatoría de la ANCP-CCE","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Retrieve one ANCP-CCE concepto by id or slug (e.g. `c-1094-de-2026`): full doctrinal text, dates, subjects and subtopics. `found: false` when nothing matches.","required":["identifier"],"request_schema":{"identifier":{"type":"string","pattern":"^(?:\\d+|[a-z0-9]+(?:-[a-z0-9]+)*)$","description":"Numeric id or slug of the concepto (e.g. `c-1094-de-2026`), as returned by the search."}},"example_request":{"identifier":"c-1094-de-2026"}},{"id":"cndj-rulings-search","name":"CNDJ Rulings Search","method":"POST","path":"/co/cndj/rulings-search/v1","url":"https://api.croma.run/co/cndj/rulings-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/cndj","country":"Colombia","source":"Relatoría de la CNDJ","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search disciplinary rulings from the Relatoría de la Comisión Nacional de Disciplina Judicial (CNDJ) by free text or the advanced filters (reporting magistrate, topic, respondent, matter, subtopic, filing year). Returns the matching summaries with their `numero_unico` + `numero_ficha` key; read one in full with `cndj-ruling`.","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Texto de búsqueda general (providencias disciplinarias)."},"reporting_judge":{"type":"string","maxLength":120,"default":"","description":"Filtro por magistrado ponente."},"subject":{"type":"string","maxLength":120,"default":"","description":"Filtro por tema."},"respondent":{"type":"string","maxLength":120,"default":"","description":"Filtro por nombre del disciplinado."},"matter":{"type":"string","maxLength":120,"default":"","description":"Filtro por asunto."},"subtopic":{"type":"string","maxLength":120,"default":"","description":"Filtro por restrictor."},"year":{"type":"string","default":"","description":"Filtro opcional por año de radicación (4 dígitos)."},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Número máximo de resultados a devolver."}},"example_request":{"query":"prescripción","limit":25}},{"id":"cndj-ruling","name":"CNDJ Ruling","method":"POST","path":"/co/cndj/ruling/v1","url":"https://api.croma.run/co/cndj/ruling/v1","docs_url":"https://docs.usecroma.com/guides/colombia/cndj","country":"Colombia","source":"Relatoría de la CNDJ","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Retrieve one CNDJ disciplinary ruling by its `registration_number` + `ficha_number` key: the editorial fields (titulación, descriptores, fuentes normativas, salvamentos) plus the ruling document and its extracted full text when it carries a text layer. `found: false` when no document is stored for that key.","required":["registration_number","ficha_number"],"request_schema":{"registration_number":{"type":"string","pattern":"^\\d{23}$","description":"Numero unico de la radicación (`numero_unico` de la búsqueda)."},"ficha_number":{"type":"integer","minimum":1,"description":"Número de ficha de la radicación (`numero_ficha` de la búsqueda)."}},"example_request":{"registration_number":"11001010200020200012300","ficha_number":12345}},{"id":"fiscalia-case","name":"Fiscalía Criminal Case by Number","method":"POST","path":"/co/fiscalia/case/v1","url":"https://api.croma.run/co/fiscalia/case/v1","docs_url":"https://docs.usecroma.com/guides/colombia/fiscalia","country":"Colombia","source":"Fiscalía General de la Nación","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up a Colombian criminal case by its 21-digit noticia criminal number, live from the Fiscalía General de la Nación (SPOA): status and closing reason, procedural stage, applicable law, date and place of the facts, the assigned prosecutor's office with its contact details, the offences with their grade, and the non-reserved actions, newest first. Returns `found: false` when the Fiscalía has no case with that number.","required":["registration_number"],"request_schema":{"registration_number":{"type":"string","minLength":21,"maxLength":21,"pattern":"^\\d{21}$","description":"Número de la noticia criminal (SPOA), de 21 dígitos, p. ej. `110016000050202154481`."}},"example_request":{"registration_number":"110016000050202154481"}},{"id":"anm-notices-search","name":"ANM Notices Search","method":"POST","path":"/co/anm/notices-search/v1","url":"https://api.croma.run/co/anm/notices-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/anm","country":"Colombia","source":"Agencia Nacional de Minería (ANM)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every notice the Agencia Nacional de Minería (Colombia) has published since May 2020 to notify decisions on mining titles and applications: estados, avisos, edictos and notices of general character. Filter by `title_number` (the placa, exact match), `office` (regional office), `type`, `year` and the publication date (`from_date`/`to_date`); free text matches the notice number and the full text. Each result lists every placa the notice covers and links to its document. Read one notice's full text with `anm_notice`. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the notice number and the full text."},"title_number":{"type":"string","maxLength":40,"default":"","description":"Optional placa (mining title or application number), e.g. `ABC-12345`. Exact match; case and spaces are ignored."},"office":{"type":"string","enum":["","bogota","bucaramanga","cali","cartagena","cucuta","ibague","manizales","medellin","nobsa","pasto","quibdo","valledupar"],"default":"","description":"Optional regional office: `bogota`, `bucaramanga`, `cali`, `cartagena`, `cucuta`, `ibague`, `manizales`, `medellin`, `nobsa`, `pasto`, `quibdo` or `valledupar`. The same slug comes back in `office_key`."},"type":{"type":"string","enum":["","estado","aviso","edicto","caracter_general"],"default":"","description":"Optional kind of notice: `estado`, `aviso`, `edicto` or `caracter_general`."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year of publication. 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"office":"bogota","type":"estado"}},{"id":"anm-notice","name":"ANM Notice","method":"POST","path":"/co/anm/notice/v1","url":"https://api.croma.run/co/anm/notice/v1","docs_url":"https://docs.usecroma.com/guides/colombia/anm","country":"Colombia","source":"Agencia Nacional de Minería (ANM)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one notice of the Agencia Nacional de Minería (Colombia) by its `id` from a search result (e.g. `GGDN-2026-P-0378.pdf`) or its `document_url`: its full text, the notice number, kind, regional office, publication date, every placa it covers and the link to its document. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false. Find a `notice_id` with `anm_notices_search`.","required":["notice_id"],"request_schema":{"notice_id":{"type":"string","minLength":5,"maxLength":400,"description":"The notice's `id` from a search result, e.g. `GGDN-2026-P-0378.pdf`. Its `document_url` works too."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"notice_id":"GGDN-2026-P-0378.pdf"}},{"id":"contraloria-fiscal-records","name":"Contraloría Fiscal Records","method":"POST","path":"/co/contraloria/fiscal-records/v1","url":"https://api.croma.run/co/contraloria/fiscal-records/v1","docs_url":"https://docs.usecroma.com/guides/colombia/contraloria","country":"Colombia","source":"Contraloría","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Check whether a person is reported as a responsable fiscal in the Contraloría's SIBOR boletín (certificado de antecedentes de responsabilidad fiscal). `document_type` defaults to `CC`. Returns the verdict, the processes it is reported in and a verification code.","required":["document_number"],"request_schema":{"document_type":{"type":"string","enum":["CC","CE","TI","PA","PEP","PPT"],"default":"CC","description":"Colombian document type. Defaults to `CC`."},"document_number":{"type":"string","minLength":3,"maxLength":30,"description":"Document number (alphanumeric with hyphens allowed)."}},"example_request":{"document_number":"1234567890"}},{"id":"dian-doctrina-search","name":"DIAN Doctrina Search","method":"POST","path":"/co/dian/doctrina-search/v1","url":"https://api.croma.run/co/dian/doctrina-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dian","country":"Colombia","source":"DIAN","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Full-text search over DIAN's published tax doctrine and related legal compilation: oficios, conceptos, decretos, resoluciones, leyes and high-court rulings. Each hit carries the `document_id` used by `dian-doctrina-document`, plus the title, issuing body, epigraph and a matching excerpt. Optional filters: `document_type` (e.g. `Oficios`, `Conceptos`) and `year`. Paginated with `page` and `per_page`; `capped: true` means the source returned more matches than are retrievable, so narrow the query.","required":["query"],"request_schema":{"query":{"type":"string","minLength":2,"maxLength":300,"description":"Términos de búsqueda en el texto de la doctrina (p. ej. `dividendos`)."},"document_type":{"type":"string","maxLength":60,"default":"","description":"Filtro por tipo de documento (p. ej. `Oficios`, `Conceptos`). Vacío para todos."},"year":{"type":"string","default":"","description":"Filtro por año de expedición (yyyy). Vacío para todos."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Resultados por página (1-100)."}},"example_request":{"query":"dividendos","document_type":"Conceptos"}},{"id":"dian-doctrina-document","name":"DIAN Doctrina Document","method":"POST","path":"/co/dian/doctrina/v1","url":"https://api.croma.run/co/dian/doctrina/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dian","country":"Colombia","source":"DIAN","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Retrieve the text of one DIAN doctrine document by the `document_id` returned by `dian-doctrina-search`: the official title and the body of the oficio, concepto or norm. Compiled norms run to millions of characters, so the body is returned in character ranges: `content.total_length` is the full size, and when `content.has_more` is true request the next range with `offset: content.next_offset`. `found: false` when no document carries that id.","required":["document_id"],"request_schema":{"document_id":{"type":"string","pattern":"^[A-Za-z0-9_()\\[\\]-]{3,120}$","description":"`document_id` devuelto por la búsqueda (p. ej. `oficio_dian_18075_2023`)."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"document_id":"oficio_dian_18075_2023"}},{"id":"dian-electronic-document","name":"DIAN Electronic Document","method":"POST","path":"/co/dian/electronic-document/v1","url":"https://api.croma.run/co/dian/electronic-document/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dian","country":"Colombia","source":"DIAN","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Validate a Colombian electronic document (factura electrónica, nota crédito/débito) by its CUFE/UUID and the emisor or receptor NIT. Returns the issuer, recipient, totals and taxes (whole pesos, as the registry publishes them), current legitimate holder, validations, and events, each with its `code` (030, 032, 033...), name, date and parties. Set `include_pdf: true` to also receive `pdf_url`, the URL of the official PDF representation. The issuer may protect that PDF with a password; when handing it over, tell the user which passwords to try, in this order: (1) the issuer's NIT without check digit (`issuer.nit`, e.g. 900108281), the most common; (2) the recipient's document number without check digit (`recipient.nit`); (3) the recipient's NIT with its check digit appended. If none works, point the user to DIAN's public catalog (https://catalogo-vpfe.dian.gov.co/User/SearchDocument), where pasting the CUFE downloads DIAN's own graphical representation. Do not try to open or extract a protected PDF with other tools; give the user the link and the password hints instead. A result is reused for 24 hours; pass `cache: false` to read the registry again, for instance after filing an event. `found: false` means the document is not registered under that CUFE, or the NIT matches neither the emisor nor the receptor.","required":["cufe","document_number"],"request_schema":{"cufe":{"type":"string","minLength":30,"maxLength":100,"pattern":"^[A-Za-z0-9-]{30,100}$","description":"CUFE/CUDE (unique electronic-document code) or UUID of the document."},"document_number":{"type":"string","minLength":4,"maxLength":15,"pattern":"^\\d{4,15}$","description":"Colombian NIT (numeric, no verification digit). 4-15 digits."},"include_pdf":{"type":"boolean","default":false,"description":"When true, the response includes `pdf_url`, the URL of the official PDF representation of the document."},"cache":{"type":"boolean","default":true,"description":"Set to `false` to skip any stored result for this lookup and read the source again. The fresh answer replaces the stored one and is charged as a new request. Default `true`."}},"example_request":{"cufe":"0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","document_number":"900123456"}},{"id":"dian-muisca-electronic-invoices","name":"DIAN Electronic Invoices","method":"POST","path":"/co/dian-muisca/electronic-invoices/v1","url":"https://api.croma.run/co/dian-muisca/electronic-invoices/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dian-muisca","country":"Colombia","source":"DIAN","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Read the electronic invoices issued to the connected DIAN account holder in one tax year (2023 onward): issuer, dates, invoiced and net amounts, deductible amount, payment method, invoice number and CUFE, with totals. Persons only: runs as your organization's own DIAN connection signed in on its own behalf.","required":["year"],"request_schema":{"year":{"type":"integer","minimum":2023,"maximum":2100,"description":"Tax year (año gravable), from 2023 to the last year that has ended."},"connection_id":{"type":"string","default":"","description":"Optional. Run as this connection (`conn_…`). Empty lets Croma pick among your organization's connections, moving to the next one when one reaches its daily allowance."}},"example_request":{"year":2024}},{"id":"dian-muisca-third-party-reports","name":"DIAN Third-Party Reports","method":"POST","path":"/co/dian-muisca/third-party-reports/v1","url":"https://api.croma.run/co/dian-muisca/third-party-reports/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dian-muisca","country":"Colombia","source":"DIAN","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Read what third parties reported to DIAN about the connected account holder (the person, or the company the connection signs in for) in one tax year (información exógena, 2018 onward): the reporter, the concept and amount, and from 2023 the suggested use in the tax return, additional detail and the filing-threshold summary. Runs as your organization's own DIAN connection.","required":["year"],"request_schema":{"year":{"type":"integer","minimum":2018,"maximum":2100,"description":"Tax year (año gravable), from 2018 to the last year that has ended."},"connection_id":{"type":"string","default":"","description":"Optional. Run as this connection (`conn_…`). Empty lets Croma pick among your organization's connections, moving to the next one when one reaches its daily allowance."}},"example_request":{"year":2024}},{"id":"dian-facturacion-access-requests","name":"DIAN Invoicing Access Request","method":"POST","path":"/co/dian-facturacion/access-requests/v1","url":"https://api.croma.run/co/dian-facturacion/access-requests/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dian-facturacion","country":"Colombia","source":"DIAN","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Ask DIAN to email an access link for its electronic-invoicing system to the address in the person's RUT (for a company, its legal representative's). Register the link as a dian-facturacion connection within 60 minutes. Runs without a connection.","required":["document_number"],"request_schema":{"document_type":{"type":"string","enum":["CC","CE","TI","RC","PA","NIT"],"default":"CC","description":"Colombian document type. Defaults to `CC`."},"document_number":{"type":"string","pattern":"^[A-Za-z0-9-]{3,30}$","description":"The document number of the person the access is for (the legal representative's, for a company), without dots or commas. DIAN sends the link to the email registered in that person's RUT."},"company_nit":{"type":"string","pattern":"^(\\d{5,10})?$","default":"","description":"Optional. The NIT of the company the access is for, without the verification digit, dots or dashes; `document_number` is then its legal representative's. Empty asks for the person's own access."}},"example_request":{"document_type":"CC","document_number":"1234567890","company_nit":"900123456"}},{"id":"dian-facturacion-issued-documents","name":"DIAN Issued Electronic Documents","method":"POST","path":"/co/dian-facturacion/issued-documents/v1","url":"https://api.croma.run/co/dian-facturacion/issued-documents/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dian-facturacion","country":"Colombia","source":"DIAN","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"List the electronic documents the connected account issued in a date range (up to a year): invoices, credit and debit notes, support documents, payroll and events, each with its CUFE, number, dates, recipient, currency, payment form and method, every tax and withholding, total, DIAN status and RADIAN status, with counts and totals per type. Runs as your organization's own dian-facturacion connection.","required":["from_date","to_date"],"request_schema":{"from_date":{"type":"string","format":"date","description":"First issue date to include, `yyyy-mm-dd`."},"to_date":{"type":"string","format":"date","description":"Last issue date to include, `yyyy-mm-dd`. At most a year after `from_date`."},"connection_id":{"type":"string","default":"","description":"Optional. Run as this connection (`conn_…`). Empty lets Croma pick among your organization's connections, moving to the next one when one reaches its daily allowance."}},"example_request":{"from_date":"2026-01-01","to_date":"2026-06-30"}},{"id":"dian-facturacion-received-documents","name":"DIAN Received Electronic Documents","method":"POST","path":"/co/dian-facturacion/received-documents/v1","url":"https://api.croma.run/co/dian-facturacion/received-documents/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dian-facturacion","country":"Colombia","source":"DIAN","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"List the electronic documents the connected account received in a date range (up to a year): invoices from its suppliers, credit and debit notes and events, each with its CUFE, number, dates, issuer, currency, payment form and method, every tax and withholding, total, DIAN status and RADIAN status, with counts and totals per type. Runs as your organization's own dian-facturacion connection.","required":["from_date","to_date"],"request_schema":{"from_date":{"type":"string","format":"date","description":"First issue date to include, `yyyy-mm-dd`."},"to_date":{"type":"string","format":"date","description":"Last issue date to include, `yyyy-mm-dd`. At most a year after `from_date`."},"connection_id":{"type":"string","default":"","description":"Optional. Run as this connection (`conn_…`). Empty lets Croma pick among your organization's connections, moving to the next one when one reaches its daily allowance."}},"example_request":{"from_date":"2026-01-01","to_date":"2026-06-30"}},{"id":"dian-facturacion-document","name":"DIAN Electronic Document","method":"POST","path":"/co/dian-facturacion/document/v1","url":"https://api.croma.run/co/dian-facturacion/document/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dian-facturacion","country":"Colombia","source":"DIAN","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Read one electronic document of the connected account in full: header, lines with quantities, prices and taxes, monetary totals, payment terms, notes, the legitimate holder, DIAN's validations, its RADIAN events, and the original XML (UBL 2.1) and PDF. Takes the CUFE and issue date from the issued or received documents. Runs as your organization's own dian-facturacion connection.","required":["cufe","issued_on"],"request_schema":{"cufe":{"type":"string","minLength":30,"maxLength":100,"pattern":"^[A-Za-z0-9-]{30,100}$","description":"CUFE/CUDE (unique electronic-document code) or UUID of the document."},"issued_on":{"type":"string","format":"date","description":"The document's issue date, `yyyy-mm-dd`, as the issued or received documents list it (`issued_on`)."},"connection_id":{"type":"string","default":"","description":"Optional. Run as this connection (`conn_…`). Empty lets Croma pick among your organization's connections, moving to the next one when one reaches its daily allowance."}},"example_request":{"cufe":"a1b2c3d4e5f60718a1b2c3d4e5f60718a1b2c3d4e5f60718a1b2c3d4e5f60718a1b2c3d4e5f60718a1b2c3d4e5f60718","issued_on":"2026-03-09"}},{"id":"dian-facturacion-monthly-reports","name":"DIAN Electronic Invoicing Monthly Report","method":"POST","path":"/co/dian-facturacion/monthly-reports/v1","url":"https://api.croma.run/co/dian-facturacion/monthly-reports/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dian-facturacion","country":"Colombia","source":"DIAN","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Read DIAN's monthly electronic-invoicing report for the connected account: documents registered in the month and in the year so far, per document type, issued and received, with amounts, and DIAN's indicators for the last three months. Runs as your organization's own dian-facturacion connection.","required":["year","month"],"request_schema":{"year":{"type":"integer","minimum":2019,"maximum":2100,"description":"The report's year."},"month":{"type":"integer","minimum":1,"maximum":12,"description":"The report's month, 1 to 12."},"connection_id":{"type":"string","default":"","description":"Optional. Run as this connection (`conn_…`). Empty lets Croma pick among your organization's connections, moving to the next one when one reaches its daily allowance."}},"example_request":{"year":2025,"month":12}},{"id":"dian-facturacion-profile","name":"DIAN Electronic Invoicing Profile","method":"POST","path":"/co/dian-facturacion/profile/v1","url":"https://api.croma.run/co/dian-facturacion/profile/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dian-facturacion","country":"Colombia","source":"DIAN","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Read the connected account's profile in DIAN's electronic-invoicing system: NIT, name, status, the email where it receives invoices, its legal representatives, operation modes and software, and the numbering ranges (prefix, resolution, range, dates). Runs as your organization's own dian-facturacion connection.","required":[],"request_schema":{"connection_id":{"type":"string","default":"","description":"Optional. Run as this connection (`conn_…`). Empty lets Croma pick among your organization's connections, moving to the next one when one reaches its daily allowance."}},"example_request":{}},{"id":"dian-trade-directory-search","name":"DIAN Importers and Exporters Search","method":"POST","path":"/co/dian-trade/directory-search/v1","url":"https://api.croma.run/co/dian-trade/directory-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dian-trade","country":"Colombia","source":"DIAN Importers and Exporters","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search DIAN's directories of importers and exporters of goods, every year since 2017 and both directories at once: by company name (`query`), `flow` (`import` or `export`), `year`, and `tariff_code` (a 4-digit heading, 6-digit HS subheading or 10-digit subpartida among each company's five main ones). Each result is one company's row in one year's directory: NIT, name, rank, CIF (imports) or FOB (exports) value in US dollars, net weight, declarations or declaration items, and its main subpartidas arancelarias. Newest year first, then by value. Served by Croma (`as_of` says how current the data is), brought up to date weekly.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional words matched against the name (razón social) as DIAN prints it."},"flow":{"type":"string","enum":["any","import","export"],"default":"any","description":"Which directory: `import` (importers, valued CIF), `export` (exporters, valued FOB), or `any`."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional directory year (2017 or later). 0 searches every year."},"tariff_code":{"type":"string","pattern":"^(?:\\d{4}|\\d{6}|\\d{10})?$","default":"","description":"Optional tariff code, digits only, matched against the five main subpartidas of each row: a 4-digit heading (`8703`), a 6-digit HS subheading (`870323`) or a full 10-digit subpartida (`8703239090`)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"flow":"import","year":2025,"tariff_code":"8703"}},{"id":"dian-trade-profile","name":"DIAN Company Trade Profile","method":"POST","path":"/co/dian-trade/profile/v1","url":"https://api.croma.run/co/dian-trade/profile/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dian-trade","country":"Colombia","source":"DIAN Importers and Exporters","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"A Colombian company's foreign trade history by NIT, from DIAN's yearly directories of importers and exporters since 2017: its row in each year's importers directory (rank, CIF value in US dollars, net weight, declarations, main subpartidas arancelarias) and in each year's exporters directory (rank, FOB value, net weight, declaration items, main subpartidas), newest first. `found: false` when the NIT appears in no directory. Served by Croma (`as_of` says how current the data is), brought up to date weekly.","required":["document_number"],"request_schema":{"document_number":{"type":"string","minLength":4,"maxLength":15,"pattern":"^\\d{4,15}$","description":"Colombian NIT (numeric, no verification digit). 4-15 digits."}},"example_request":{"document_number":"899999068"}},{"id":"dane-labour-market","name":"DANE Labour Market","method":"POST","path":"/co/dane/labour-market/v1","url":"https://api.croma.run/co/dane/labour-market/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dane","country":"Colombia","source":"DANE","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Colombia's labour-market series from DANE's household survey (GEIH): unemployment (TD), employment (TO), participation (TGP) and underemployment (TS) rates and the populations behind them, monthly for the nation (total and cabeceras) since 2001 and for the 13 main cities, as rolling quarters for 23 cities and metropolitan areas since 2007, and as rolling years for 32 cities since 2021. Filter by DIVIPOLA code, territory level, indicator, period type, domain and date range. Newest first. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"territory_code":{"type":"string","pattern":"^(?:\\d{2}|\\d{5})?$","default":"","description":"Optional DIVIPOLA code: 2 digits for a department (`44`), 5 for a municipality (`44001`)."},"territory_level":{"type":"string","enum":["","national","region","department","metropolitan_area","city","city_aggregate"],"default":"","description":"Optional kind of territory: `national`, `region`, `department`, `metropolitan_area`, `city` or `city_aggregate` (a group of cities, e.g. the 13 main cities)."},"indicator_code":{"type":"string","enum":["","unemployment_rate","employment_rate","participation_rate","underemployment_rate","working_age_share","unemployment_underemployment_rate","unemployment_potential_labour_force_rate","labour_underutilization_rate","population","working_age_population","labour_force","employed","unemployed","outside_labour_force","underemployed","potential_labour_force"],"default":"","description":"Optional indicator, e.g. `unemployment_rate` (TD), `employment_rate` (TO), `participation_rate` (TGP). Empty returns every indicator."},"period_type":{"type":"string","enum":["","monthly","rolling_quarter","rolling_year"],"default":"","description":"Optional period type: `monthly`, `rolling_quarter` (three months ending in `period`) or `rolling_year` (twelve months ending in `period`)."},"domain":{"type":"string","enum":["","total","urban","rural"],"default":"","description":"Optional domain: `total`, `urban` (cabeceras) or `rural` (centros poblados y rural disperso)."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":500,"default":100,"description":"Results per page (1-500)."}},"example_request":{"indicator_code":"unemployment_rate","territory_level":"national","period_type":"monthly","domain":"total","from_date":"2025-01-01"}},{"id":"dane-poverty","name":"DANE Poverty","method":"POST","path":"/co/dane/poverty/v1","url":"https://api.croma.run/co/dane/poverty/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dane","country":"Colombia","source":"DANE","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Colombia's poverty and inequality from DANE: monetary and extreme poverty (incidence and people), Gini coefficient, income per capita and poverty lines for the nation, 23 departments and Bogotá since 2021; and multidimensional poverty (IPM) for the nation and its regions since 2010 and for all 33 departments since 2018, by total, cabeceras and rural. Filter by DIVIPOLA code, territory level, indicator, domain and years. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"territory_code":{"type":"string","pattern":"^(?:\\d{2}|\\d{5})?$","default":"","description":"Optional DIVIPOLA code: 2 digits for a department (`44`), 5 for a municipality (`44001`)."},"territory_level":{"type":"string","enum":["","national","region","department","metropolitan_area","city","city_aggregate"],"default":"","description":"Optional kind of territory: `national`, `region`, `department`, `metropolitan_area`, `city` or `city_aggregate` (a group of cities, e.g. the 13 main cities)."},"indicator_code":{"type":"string","enum":["","monetary_poverty_rate","monetary_poverty_persons","extreme_poverty_rate","extreme_poverty_persons","gini","income_per_capita","poverty_line","extreme_poverty_line","multidimensional_poverty_rate"],"default":"","description":"Optional indicator, e.g. `monetary_poverty_rate`, `extreme_poverty_rate`, `multidimensional_poverty_rate` (IPM), `gini`. Empty returns every indicator."},"domain":{"type":"string","enum":["","total","urban","rural"],"default":"","description":"Optional domain: `total`, `urban` (cabeceras) or `rural` (centros poblados y rural disperso)."},"year_from":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional first year (inclusive). 0 sets no lower bound."},"year_to":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional last year (inclusive). 0 sets no upper bound."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":500,"default":100,"description":"Results per page (1-500)."}},"example_request":{"territory_code":"44","indicator_code":"multidimensional_poverty_rate","domain":"total"}},{"id":"dane-municipal-ipm","name":"DANE Municipal IPM","method":"POST","path":"/co/dane/municipal-ipm/v1","url":"https://api.croma.run/co/dane/municipal-ipm/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dane","country":"Colombia","source":"DANE","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Multidimensional poverty (IPM) of each of Colombia's 1,122 municipalities from the 2018 census (DANE), by total, cabecera and rural, with the fifteen deprivations behind it (illiteracy, informal work, health insurance, water, overcrowding...). Filter by DIVIPOLA code (a municipality, or every municipality of a department) or by name. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"territory_code":{"type":"string","pattern":"^(?:\\d{2}|\\d{5})?$","default":"","description":"Optional DIVIPOLA code: 2 digits for a department (`44`), 5 for a municipality (`44001`)."},"query":{"type":"string","maxLength":100,"default":"","description":"Optional words of the municipality's name, e.g. `riohacha`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":500,"default":100,"description":"Results per page (1-500)."}},"example_request":{"territory_code":"44001"}},{"id":"dane-census-municipalities","name":"DANE Census by Municipality","method":"POST","path":"/co/dane/census-municipalities/v1","url":"https://api.croma.run/co/dane/census-municipalities/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dane","country":"Colombia","source":"DANE","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"The 2018 national population and housing census (CNPV, DANE) for each of Colombia's 1,122 municipalities: people by sex and age, education, households, dwellings by type and occupancy, public services and internet, dwellings by estrato as billed for electricity, and land use. Filter by DIVIPOLA code (a municipality, or every municipality of a department) or by name. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"territory_code":{"type":"string","pattern":"^(?:\\d{2}|\\d{5})?$","default":"","description":"Optional DIVIPOLA code: 2 digits for a department (`44`), 5 for a municipality (`44001`)."},"query":{"type":"string","maxLength":100,"default":"","description":"Optional words of the municipality's name, e.g. `riohacha`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":500,"default":100,"description":"Results per page (1-500)."}},"example_request":{"territory_code":"44001"}},{"id":"funcion-publica-norms-search","name":"Función Pública Norms Search","method":"POST","path":"/co/funcion-publica/norms-search/v1","url":"https://api.croma.run/co/funcion-publica/norms-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/funcion-publica","country":"Colombia","source":"Función Pública","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the Gestor Normativo, the Colombian state's register of the norms that govern public administration: laws, decrees, conceptos, rulings, circulares and acuerdos from 1620 to today, across every kind and year at once. Free text matches the norm's citation, the register's own one-line description and the full text of the norm itself. Filter by `document_type`, `year`, exact `number` (with or without leading zeros), issuing `entity`, the `subject` the register files it under, and the date it was issued (`issued_from`/`issued_to`). Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the norm's citation, the register's one-line description and the full text of the norm itself."},"document_type":{"type":"string","maxLength":60,"default":"","description":"Optional kind of instrument: `ley`, `decreto`, `concepto`, `sentencia`, `acuerdo`, `resolucion`, `circular`, `circular-externa`, `decreto-ley`, `acto-legislativo`, `directiva`, `auto`, `constitucion-politica` and others. Case and accents are ignored."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year in the norm's own designation (the 2008 of `Ley 1266 de 2008`). 0 searches every year."},"number":{"type":"string","maxLength":40,"default":"","description":"Optional norm number, with or without leading zeros (`1266`, `007`, `100-010`, `2017-00230`)."},"entity":{"type":"string","maxLength":120,"default":"","description":"Optional issuing entity, matched from the start of the name: `congreso` finds the Congreso de la República, `ministerio-de-hacienda` the ministry. Case and accents are ignored. `nivel-nacional` is how the register labels norms of the national executive."},"subject":{"type":"string","maxLength":120,"default":"","description":"Optional subject heading the register files the norm under, matched exactly as it publishes it, e.g. `HABEAS DATA`, `CARRERA ADMINISTRATIVA`."},"issued_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"issued_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"habeas data","document_type":"ley"}},{"id":"funcion-publica-norm","name":"Función Pública Norm","method":"POST","path":"/co/funcion-publica/norm/v1","url":"https://api.croma.run/co/funcion-publica/norm/v1","docs_url":"https://docs.usecroma.com/guides/colombia/funcion-publica","country":"Colombia","source":"Función Pública","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one norm of the Gestor Normativo by its `norm_id` from the search results: its consolidated text, the dates it was issued and entered into force, where it was officially published, the subjects the register files it under, and the later norms it records as having added to, modified or repealed it. The text comes back a character range at a time (`offset`, `limit`), because the longest norms run past a million characters; follow `next_offset` until `has_more` is false.","required":["norm_id"],"request_schema":{"norm_id":{"type":"string","pattern":"^\\d{1,12}$","description":"Norm identifier from the search results (`id`), e.g. `34488`."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"norm_id":"34488"}},{"id":"imprenta-gaceta-documents-search","name":"Gaceta del Congreso Documents","method":"POST","path":"/co/imprenta/gaceta-documents-search/v1","url":"https://api.croma.run/co/imprenta/gaceta-documents-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/imprenta","country":"Colombia","source":"Imprenta Nacional","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search everything the Colombian Congress has published in the Gaceta del Congreso since 2000, document by document: proyectos de ley as filed, informes de ponencia, actas de comisión y plenaria, textos aprobados y definitivos, informes de conciliación, objeciones presidenciales and conceptos. Search the full text, or filter by `chamber`, `kind`, and by the bill a document is about (`bill_number`, `bill_year`) to follow one proyecto de ley through every stage of its passage. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional free-text search. Matches the document's title, its epígrafe and its full text."},"chamber":{"type":"string","enum":["any","senado","camara"],"default":"any","description":"Chamber: `senado` (Senado de la República), `camara` (Cámara de Representantes), or `any`."},"kind":{"type":"string","enum":["any","proyecto","ponencia","acta","texto","conciliacion","objecion","concepto","ley","otro"],"default":"any","description":"Kind of document: `proyecto` (a bill as filed), `ponencia` (a committee report), `acta` (minutes of a sitting), `texto` (an approved or definitive text), `conciliacion`, `objecion`, `concepto`, `ley`, `otro`, or `any`."},"bill_number":{"type":"string","maxLength":10,"default":"","description":"Optional number. Leading zeros are ignored, so `02` and `2` match the same thing."},"bill_year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year the bill was filed. 0 searches every year."},"published_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"published_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"reforma pensional","kind":"ponencia"}},{"id":"imprenta-gaceta-document","name":"Gaceta del Congreso Document","method":"POST","path":"/co/imprenta/gaceta-document/v1","url":"https://api.croma.run/co/imprenta/gaceta-document/v1","docs_url":"https://docs.usecroma.com/guides/colombia/imprenta","country":"Colombia","source":"Imprenta Nacional","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one document published in the Gaceta del Congreso by its `document_id` from the search results (e.g. `87176`), with its full text as the Gaceta published it, the issue it appeared in, and the proyecto de ley it belongs to.","required":["document_id"],"request_schema":{"document_id":{"type":"string","minLength":1,"maxLength":20,"description":"The document's identifier, e.g. `87176`."}},"example_request":{"document_id":"87176"}},{"id":"imprenta-gacetas-search","name":"Gaceta del Congreso Issues","method":"POST","path":"/co/imprenta/gacetas-search/v1","url":"https://api.croma.run/co/imprenta/gacetas-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/imprenta","country":"Colombia","source":"Imprenta Nacional","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Browse the issues of the Gaceta del Congreso themselves: every issue either chamber has published since 2000, by number, chamber and publication date. Use this to find an issue by its citation; use the Documents endpoint to search what is inside them.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional free-text search. Matches the document's title, its epígrafe and its full text."},"chamber":{"type":"string","enum":["any","senado","camara"],"default":"any","description":"Chamber: `senado` (Senado de la República), `camara` (Cámara de Representantes), or `any`."},"number":{"type":"string","maxLength":10,"default":"","description":"Optional number. Leading zeros are ignored, so `02` and `2` match the same thing."},"published_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"published_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"chamber":"senado","published_from":"2026-08-01"}},{"id":"imprenta-diarios-search","name":"Diario Oficial Issues","method":"POST","path":"/co/imprenta/diarios-search/v1","url":"https://api.croma.run/co/imprenta/diarios-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/imprenta","country":"Colombia","source":"Imprenta Nacional","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Browse the Diario Oficial, the gazette where Colombian law takes effect: every issue the Imprenta Nacional lists, from number 23,962 of 2 January 1939 to this week's, by number, edition and publication date.","required":[],"request_schema":{"number":{"type":"string","maxLength":15,"default":"","description":"Optional Diario Oficial issue number. The thousands separator is ignored, so `53.609` and `53609` match the same issue."},"edition":{"type":"string","enum":["any","ordinaria","extraordinaria","especial","oficio_tributario","otra"],"default":"any","description":"Edition: `ordinaria` (the daily edition), `extraordinaria`, `especial`, `oficio_tributario`, `otra`, or `any`."},"published_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"published_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"published_from":"2026-08-01"}},{"id":"igac-properties-search","name":"IGAC Properties Search","method":"POST","path":"/co/igac/properties-search/v1","url":"https://api.croma.run/co/igac/properties-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac","country":"Colombia","source":"IGAC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the properties (predios) of Colombia's national cadastre administered by IGAC, about 6.8 million in 831 municipalities: by `municipality_code` (DANE), `block_code` (the manzana or vereda, the first 17 digits of a cadastral number), words of the `address`, `economic_destination` (`A` housing, `C` commerce, `D` agricultural and others), `zone` (`urban`/`rural`) or `previous_cadastral_number`. At least a municipality, a block or a previous number is required. Each result carries the 30-digit cadastral number, address, destination, land and built areas, the land zones and every building unit with its use and score. Not for Bogotá, Medellín, Cali, Barranquilla or Antioquia, which keep their own cadastre. Read the appraisal of one with `igac_property`. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"municipality_code":{"type":"string","pattern":"^(\\d{5})?$","default":"","description":"Optional five-digit DANE code of the municipality, e.g. `17013` for Aguadas."},"query":{"type":"string","maxLength":120,"default":"","description":"Optional words matched against the property's address or farm name, e.g. `calle 10` or `la esperanza`."},"block_code":{"type":"string","pattern":"^(\\d{17})?$","default":"","description":"Optional 17-digit code of the manzana (urban) or vereda (rural): the first 17 digits of any property's cadastral number in it, e.g. `17013000100000001`."},"economic_destination":{"type":"string","maxLength":2,"default":"","description":"Optional economic destination code as IGAC assigns it: `A` housing, `B` industrial, `C` commercial, `D` agricultural, `I` institutional, `L` agricultural crops, `M` livestock, `S` urbanized lot not built, among others. Case is ignored."},"zone":{"type":"string","enum":["","urban","rural"],"default":"","description":"Optional: `urban` or `rural`."},"previous_cadastral_number":{"type":"string","pattern":"^(\\d{20})?$","default":"","description":"Optional 20-digit number the property had before the national numbering, e.g. `17013000100010001000`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"municipality_code":"17013","economic_destination":"C","zone":"urban"}},{"id":"igac-property","name":"IGAC Property","method":"POST","path":"/co/igac/property/v1","url":"https://api.croma.run/co/igac/property/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac","country":"Colombia","source":"IGAC","rate_limit":"100 requests / 24h","served_from":"lookup","monitorable":true,"description":"Retrieve one property of Colombia's national cadastre by its 30-digit número predial nacional, as IGAC's cadastre answers it today: the current avalúo catastral in pesos with its vigencia (whether the municipality's cadastre for that zone is in formación, actualización or conservación, and the year of its last update, since an avalúo carried forward for years is not comparable with a freshly updated one), address, land and built areas, economic destination, every building with its use, score and floors, and the parcel polygon. The first ask of a number reads IGAC; later asks within 30 days answer from Croma's stored answer (`served_from`), which is re-read regularly. Only for the 842 municipalities IGAC administers: a number from Bogotá, Medellín, Cali, Barranquilla or Antioquia returns `found: false`. Find numbers with `igac_properties_search` or a point with `igac_property_by_point`.","required":["cadastral_number"],"request_schema":{"cadastral_number":{"type":"string","pattern":"^[0-9 .-]{30,40}$","description":"The 30-digit número predial nacional, e.g. `170130001000000010001000000000`. Spaces, dots and hyphens are ignored."}},"example_request":{"cadastral_number":"170130001000000010001000000000"}},{"id":"igac-property-by-point","name":"IGAC Property by Point","method":"POST","path":"/co/igac/property-by-point/v1","url":"https://api.croma.run/co/igac/property-by-point/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac","country":"Colombia","source":"IGAC","rate_limit":"100 requests / 24h","served_from":"lookup","monitorable":true,"description":"Find the property of Colombia's national cadastre at a point (`latitude`, `longitude`, WGS84) and answer as `igac_property` does: the parcel IGAC draws under the point, then its current avalúo catastral, address, areas, destination, buildings and polygon, served from Croma's stored answer when it holds a recent one. `found: false` when no IGAC parcel contains the point, which includes the cities that keep their own cadastre.","required":["latitude","longitude"],"request_schema":{"latitude":{"type":"number","minimum":-4.5,"maximum":13.5,"description":"Latitude of the point, decimal degrees (WGS84), within Colombia."},"longitude":{"type":"number","minimum":-82,"maximum":-66,"description":"Longitude of the point, decimal degrees (WGS84), within Colombia."}},"example_request":{"latitude":5.6096,"longitude":-75.4557}},{"id":"igac-parcel","name":"IGAC Parcel","method":"POST","path":"/co/igac/parcel/v1","url":"https://api.croma.run/co/igac/parcel/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac","country":"Colombia","source":"IGAC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve the polygon of one parcel (terreno) of Colombia's national cadastre by its 30-digit cadastral number: the geometry as GeoJSON in WGS84, its centre, the block or vereda it sits in, the zone and the previous number. From IGAC's monthly publication, about 5.1 million parcels. Served by Croma.","required":["cadastral_number"],"request_schema":{"cadastral_number":{"type":"string","pattern":"^[0-9 .-]{30,40}$","description":"The 30-digit número predial nacional, e.g. `170130001000000010001000000000`. Spaces, dots and hyphens are ignored."}},"example_request":{"cadastral_number":"170130001000000010001000000000"}},{"id":"igac-parcels-search","name":"IGAC Parcels Search","method":"POST","path":"/co/igac/parcels-search/v1","url":"https://api.croma.run/co/igac/parcels-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac","country":"Colombia","source":"IGAC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"List the parcels (terrenos) of Colombia's national cadastre in a municipality, optionally within one block or vereda (`block_code`) or one `zone`, each with its GeoJSON polygon in WGS84, centre and previous number. About 5.1 million parcels from IGAC's monthly publication. Served by Croma.","required":["municipality_code"],"request_schema":{"municipality_code":{"type":"string","pattern":"^\\d{5}$","description":"Five-digit DANE code of the municipality, e.g. `17013` for Aguadas or `52001` for Pasto."},"block_code":{"type":"string","pattern":"^(\\d{17})?$","default":"","description":"Optional 17-digit code of the manzana (urban) or vereda (rural): the first 17 digits of any property's cadastral number in it, e.g. `17013000100000001`."},"zone":{"type":"string","enum":["","urban","rural"],"default":"","description":"Optional: `urban` or `rural`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50); every result carries its geometry."}},"example_request":{"municipality_code":"17013","block_code":"17013000100000001"}},{"id":"igac-buildings-by-property","name":"IGAC Buildings by Property","method":"POST","path":"/co/igac/buildings-by-property/v1","url":"https://api.croma.run/co/igac/buildings-by-property/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac","country":"Colombia","source":"IGAC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"List the buildings (construcciones) IGAC's cadastre draws on one property, by its 30-digit cadastral number: each with its letter, type (`CONVENCIONAL` or `NO CONVENCIONAL`), ownership regime, floors, basements, mezzanines and footprint as GeoJSON in WGS84. About 3.8 million buildings. Served by Croma.","required":["cadastral_number"],"request_schema":{"cadastral_number":{"type":"string","pattern":"^[0-9 .-]{30,40}$","description":"The 30-digit número predial nacional, e.g. `170130001000000010001000000000`. Spaces, dots and hyphens are ignored."}},"example_request":{"cadastral_number":"170130001000000010001000000000"}},{"id":"igac-blocks-search","name":"IGAC Blocks Search","method":"POST","path":"/co/igac/blocks-search/v1","url":"https://api.croma.run/co/igac/blocks-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac","country":"Colombia","source":"IGAC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"List the urban blocks (manzanas) of a municipality in Colombia's national cadastre, each with its 17-digit code, neighbourhood and GeoJSON polygon in WGS84. About 172,000 blocks. Served by Croma.","required":["municipality_code"],"request_schema":{"municipality_code":{"type":"string","pattern":"^\\d{5}$","description":"Five-digit DANE code of the municipality, e.g. `17013` for Aguadas or `52001` for Pasto."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50); every result carries its geometry."}},"example_request":{"municipality_code":"17013"}},{"id":"igac-rural-districts-search","name":"IGAC Rural Districts Search","method":"POST","path":"/co/igac/rural-districts-search/v1","url":"https://api.croma.run/co/igac/rural-districts-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac","country":"Colombia","source":"IGAC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"List the rural districts (veredas) of a municipality in Colombia's national cadastre, by name words when given, each with its 17-digit code, name, sector and GeoJSON polygon in WGS84. About 17,000 veredas. Served by Croma.","required":["municipality_code"],"request_schema":{"municipality_code":{"type":"string","pattern":"^\\d{5}$","description":"Five-digit DANE code of the municipality, e.g. `17013` for Aguadas or `52001` for Pasto."},"query":{"type":"string","maxLength":120,"default":"","description":"Optional words matched against the name, e.g. `el porvenir`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50); every result carries its geometry."}},"example_request":{"municipality_code":"17013"}},{"id":"igac-sectors-search","name":"IGAC Sectors Search","method":"POST","path":"/co/igac/sectors-search/v1","url":"https://api.croma.run/co/igac/sectors-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac","country":"Colombia","source":"IGAC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"List the cadastral sectors of a municipality in Colombia's national cadastre, urban and rural, each with its polygon, and the municipality's urban perimeters (the line dividing urban from rural land) with the centre's name and appraisal regime. Served by Croma.","required":["municipality_code"],"request_schema":{"municipality_code":{"type":"string","pattern":"^\\d{5}$","description":"Five-digit DANE code of the municipality, e.g. `17013` for Aguadas or `52001` for Pasto."},"zone":{"type":"string","enum":["","urban","rural"],"default":"","description":"Optional: `urban` or `rural`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50); every result carries its geometry."}},"example_request":{"municipality_code":"17013"}},{"id":"igac-economic-zones-search","name":"IGAC Economic Zones Search","method":"POST","path":"/co/igac/economic-zones-search/v1","url":"https://api.croma.run/co/igac/economic-zones-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac","country":"Colombia","source":"IGAC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"List the homogeneous geoeconomic zones (zonas homogéneas geoeconómicas) IGAC has adopted in a municipality, urban and rural, each with the land value per m² (urban, `value_per_m2`) or per hectare (rural, `value_per_hectare`) in pesos, the date the value is from, the physical zones it covers and its GeoJSON polygon. A property's `land_zones[].economic_zone_code` points at these; the land half of its appraisal is this value times the area. About 130,000 zones. Served by Croma.","required":["municipality_code"],"request_schema":{"municipality_code":{"type":"string","pattern":"^\\d{5}$","description":"Five-digit DANE code of the municipality, e.g. `17013` for Aguadas or `52001` for Pasto."},"zone":{"type":"string","enum":["","urban","rural"],"default":"","description":"Optional: `urban` or `rural`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50); every result carries its geometry."}},"example_request":{"municipality_code":"17013","zone":"urban"}},{"id":"igac-physical-zones-search","name":"IGAC Physical Zones Search","method":"POST","path":"/co/igac/physical-zones-search/v1","url":"https://api.croma.run/co/igac/physical-zones-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac","country":"Colombia","source":"IGAC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"List the homogeneous physical zones (zonas homogéneas físicas) IGAC has adopted in a municipality, urban and rural: topography, road influence, public services, land use and its norm and construction typology for urban zones; land class and water availability for rural ones; each with the date it is from and its GeoJSON polygon. About 190,000 zones. Served by Croma.","required":["municipality_code"],"request_schema":{"municipality_code":{"type":"string","pattern":"^\\d{5}$","description":"Five-digit DANE code of the municipality, e.g. `17013` for Aguadas or `52001` for Pasto."},"zone":{"type":"string","enum":["","urban","rural"],"default":"","description":"Optional: `urban` or `rural`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50); every result carries its geometry."}},"example_request":{"municipality_code":"17013","zone":"urban"}},{"id":"igac-municipal-statistics","name":"IGAC Municipal Statistics","method":"POST","path":"/co/igac/municipal-statistics/v1","url":"https://api.croma.run/co/igac/municipal-statistics/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac","country":"Colombia","source":"IGAC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"IGAC's cadastral statistics for one municipality of Colombia, whoever administers its cadastre, per zone and reporting year since 2017: the sum of every property's avalúo catastral (`appraisal_total`, pesos), the number of properties, built and land areas, the years of the last urban and rural updates and the cadastre's status. Optionally one `year` or one `zone`. Served by Croma.","required":["municipality_code"],"request_schema":{"municipality_code":{"type":"string","pattern":"^\\d{5}$","description":"Five-digit DANE code of the municipality, e.g. `17013` for Aguadas or `52001` for Pasto."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional reporting year, e.g. `2025`. Omit it for every year IGAC reports."},"zone":{"type":"string","enum":["","urban","rural"],"default":"","description":"Optional: `urban` or `rural`."}},"example_request":{"municipality_code":"17013"}},{"id":"igac-cadastral-managers","name":"IGAC Cadastral Managers","method":"POST","path":"/co/igac/cadastral-managers/v1","url":"https://api.croma.run/co/igac/cadastral-managers/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac","country":"Colombia","source":"IGAC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Who administers each of Colombia's 1,122 municipal cadastres, as IGAC maps it: IGAC itself for 842, a departmental, metropolitan or municipal gestor catastral for the rest. Filter by `municipality_code` or by words of the manager's or municipality's name. `is_igac` says whether the municipality's properties are in this source. Served by Croma.","required":[],"request_schema":{"municipality_code":{"type":"string","pattern":"^(\\d{5})?$","default":"","description":"Optional five-digit DANE code of the municipality, e.g. `17013` for Aguadas."},"query":{"type":"string","maxLength":120,"default":"","description":"Optional words matched against the manager's name, e.g. `antioquia` or `cundinamarca`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"query":"antioquia"}},{"id":"igac-address-plates-by-property","name":"IGAC Address Plates by Property","method":"POST","path":"/co/igac/address-plates-by-property/v1","url":"https://api.croma.run/co/igac/address-plates-by-property/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac","country":"Colombia","source":"IGAC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"The address plates (nomenclatura domiciliaria) IGAC draws for one parcel of Colombia's national cadastre, by its 30-digit cadastral number: the text of each plate and where it sits, as GeoJSON in WGS84. About 3 million plates. Served by Croma.","required":["cadastral_number"],"request_schema":{"cadastral_number":{"type":"string","pattern":"^[0-9 .-]{30,40}$","description":"The 30-digit número predial nacional, e.g. `170130001000000010001000000000`. Spaces, dots and hyphens are ignored."}},"example_request":{"cadastral_number":"170130001000000010001000000000"}},{"id":"igac-street-names-search","name":"IGAC Street Names Search","method":"POST","path":"/co/igac/street-names-search/v1","url":"https://api.croma.run/co/igac/street-names-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac","country":"Colombia","source":"IGAC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"The street names (nomenclatura vial) IGAC draws on the cadastral map of a municipality in Colombia, by words of the name when given, each with where it sits as GeoJSON in WGS84. About 150,000 names. Served by Croma.","required":["municipality_code"],"request_schema":{"municipality_code":{"type":"string","pattern":"^\\d{5}$","description":"Five-digit DANE code of the municipality, e.g. `17013` for Aguadas or `52001` for Pasto."},"query":{"type":"string","maxLength":120,"default":"","description":"Optional words matched against the name, e.g. `el porvenir`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50); every result carries its geometry."}},"example_request":{"municipality_code":"17013"}},{"id":"banrep-series-search","name":"Banco de la República Series Search","method":"POST","path":"/co/banrep/series-search/v1","url":"https://api.croma.run/co/banrep/series-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/banrep","country":"Colombia","source":"Banco de la República","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the catalog of statistical series the Banco de la República, Colombia's central bank, publishes: about 850 series covering the TRM exchange rate, the monetary policy rate, IBR, DTF and deposit rates, lending rates by credit type, credit and monetary aggregates, consumer prices, unemployment, GDP, the balance of payments, remittances and regional activity. Free text matches the name, description, keywords and categories; filter by `frequency`. Each result carries the series code, unit, producer, first and latest observation, and the last and next update dates. Read a series' observations with `banrep_series`. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional search terms matched against the series name, description, keywords and categories, e.g. `TRM`, `tasa de política monetaria`, `crédito de consumo` or `desempleo`."},"frequency":{"type":"string","enum":["","daily","weekly","monthly","quarterly","semiannual","annual"],"default":"","description":"Optional native frequency of the series: `daily`, `weekly`, `monthly`, `quarterly`, `semiannual` or `annual`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"query":"crédito de consumo","frequency":"monthly"}},{"id":"banrep-series","name":"Banco de la República Series","method":"POST","path":"/co/banrep/series/v1","url":"https://api.croma.run/co/banrep/series/v1","docs_url":"https://docs.usecroma.com/guides/colombia/banrep","country":"Colombia","source":"Banco de la República","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Read the observations of one statistical series of the Banco de la República (Colombia) by its code, the `id` of a search result, e.g. `1` (TRM), `59` (monetary policy rate), `15126` (consumer lending rate) or `15000` (consumer price index), optionally over a date range (`from_date`, `to_date`). Returns the series' metadata (name, unit, frequency, producer, last and next update) and every observation in the range as `date` and `value`, oldest first. Find a code with `banrep_series_search`. Served by Croma (`as_of` says how current the data is).","required":["series_code"],"request_schema":{"series_code":{"type":"string","pattern":"^\\d{1,8}$","description":"The Banco de la República code of the series, the `id` of a search result, e.g. `1` (TRM) or `59` (policy rate)."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."}},"example_request":{"series_code":"1","from_date":"2026-09-01","to_date":"2026-09-30"}},{"id":"banrep-research-publications-search","name":"Banco de la República Publications Search","method":"POST","path":"/co/banrep-research/publications-search/v1","url":"https://api.croma.run/co/banrep-research/publications-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/banrep-research","country":"Colombia","source":"Banco de la República: research and reports","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every publication of the Banco de la República, Colombia's central bank: the Borradores de Economía working papers, the regional and urban economics working papers, Ensayos sobre Política Económica, the monetary policy and financial stability reports, the board's reports to Congress, the regional economic bulletins and ICER reports, the labour market, credit and financial markets reports, and books, about 5,700 in all. Free text matches the title, abstracts, keywords, subjects, authors and the full text; filter by `series`, `author` surname, `jel_code` (or its prefix, e.g. `E5`), `region` (a Colombian department) and date. Each result carries the authors, date, series, abstracts, JEL codes, departments covered, DOI and links to a copy of every file. Read one publication's text with `banrep_research_publication`. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional words matched against the title, abstracts, summary, keywords, subjects, authors and full text, e.g. `remesas`, `inflación de alimentos` or `pobreza Chocó`."},"series":{"type":"string","enum":["","borradores","regional_working_papers","regional_essays","espe","monetary_policy_report","financial_stability_report","financial_stability_special_reports","financial_stability_topics","board_report_to_congress","icer","regional_bulletin","labour_market_report","credit_report","financial_markets_report","other"],"default":"","description":"Optional series: `borradores` (Borradores de Economía), `regional_working_papers` (Documentos de Trabajo sobre Economía Regional y Urbana), `regional_essays` (Ensayos sobre Economía Regional), `espe` (Ensayos sobre Política Económica), `monetary_policy_report` (Informe de Política Monetaria), `financial_stability_report` (Reporte de Estabilidad Financiera), `financial_stability_special_reports`, `financial_stability_topics`, `board_report_to_congress` (Informe de la Junta Directiva al Congreso), `icer` (Informes de Coyuntura Económica Regional), `regional_bulletin` (Boletín Económico Regional), `labour_market_report`, `credit_report`, `financial_markets_report` or `other` (books, chapters and the smaller series)."},"author":{"type":"string","maxLength":120,"default":"","description":"Optional author surname, with or without accents, e.g. `Ayala` or `Ayala-García`."},"jel_code":{"type":"string","pattern":"^([A-Za-z]\\d{0,2})?$","default":"","description":"Optional JEL classification code or its prefix: `E52` (monetary policy), `E5` (every code under it) or `R` (urban, rural and regional economics)."},"region":{"type":"string","maxLength":80,"default":"","description":"Optional Colombian department the publication covers, with or without accents, e.g. `Chocó` or `La Guajira`. The regional bulletins and ICER reports carry it."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Results per page (1-50)."}},"example_request":{"query":"remesas","series":"regional_working_papers"}},{"id":"banrep-research-publication","name":"Banco de la República Publication","method":"POST","path":"/co/banrep-research/publication/v1","url":"https://api.croma.run/co/banrep-research/publication/v1","docs_url":"https://docs.usecroma.com/guides/colombia/banrep-research","country":"Colombia","source":"Banco de la República: research and reports","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one publication of the Banco de la República (Colombia) by its handle, the `id` of a search result (e.g. `11430`), or its handle link: everything the search returns plus the text of its main document, a character range at a time (`offset`, `limit`; follow `next_offset` until `has_more` is false), and links to a copy of every file published with it. Find a handle with `banrep_research_publications_search`. Served by Croma (`as_of` says how current the data is).","required":["handle"],"request_schema":{"handle":{"type":"string","minLength":1,"maxLength":200,"description":"The publication's handle, the `id` of a search result (e.g. `11430`), or its link (`https://hdl.handle.net/20.500.12134/11430`)."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"handle":"11449"}},{"id":"icfes-saber11-schools-search","name":"ICFES Saber 11 Results by School","method":"POST","path":"/co/icfes/saber11-schools-search/v1","url":"https://api.croma.run/co/icfes/saber11-schools-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/icfes","country":"Colombia","source":"ICFES","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Saber 11 results of every Colombian school per exam period, 2010 to 2022 (Colombia's end-of-secondary exam, run by ICFES): students who sat it (each counted once) and their mean global score (0 to 500) and mean score in mathematics, critical reading, natural sciences, social studies and English, with the school's DANE code, name, sector, calendar, area and municipality. Free text matches the school and municipality names. Filter by `school_code` (12-digit DANE), `territory_code` (5-digit DIVIPOLA municipality or 2-digit department), `year`, `period` (`yyyy-1` or `yyyy-2`) and `school_sector` (`oficial`, `no_oficial`). Newest period first, highest mean global score first within it. 2018-2 and 2021-2 are not published. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional words matched against the school's name and its municipality."},"school_code":{"type":"string","pattern":"^(\\d{12})?$","default":"","description":"Optional DANE code of the school (establecimiento educativo), 12 digits, e.g. `111001000078`."},"territory_code":{"type":"string","pattern":"^(\\d{2}|\\d{5})?$","default":"","description":"Optional DIVIPOLA code: 5 digits for one municipality (e.g. `05001`, Medellín) or 2 digits for every municipality of a department (e.g. `05`, Antioquia)."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional exam year, 2010 to 2022. 0 returns every year."},"period":{"type":"string","pattern":"^(\\d{4}-[12])?$","default":"","description":"Optional exam period as `yyyy-1` (the first sitting of the year) or `yyyy-2` (the second), e.g. `2022-2`."},"school_sector":{"type":"string","enum":["","oficial","no_oficial"],"default":"","description":"Optional sector of the school: `oficial` (public) or `no_oficial` (private)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"territory_code":"11001","period":"2022-2","school_sector":"oficial"}},{"id":"icfes-saber11-strata-search","name":"ICFES Saber 11 Results by Stratum","method":"POST","path":"/co/icfes/saber11-strata-search/v1","url":"https://api.croma.run/co/icfes/saber11-strata-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/icfes","country":"Colombia","source":"ICFES","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Saber 11 results of every Colombian municipality by the socioeconomic stratum of the students' homes, per exam period, 2010 to 2022 (Colombia's end-of-secondary exam, run by ICFES): students who sat it (each counted once) and their mean global and per-area scores. Stratum is `1` to `6`, `sin_estrato` or `no_reportado`, as each student reported it. Filter by `territory_code` (5-digit DIVIPOLA municipality of the school or 2-digit department), `year`, `period` (`yyyy-1` or `yyyy-2`) and `stratum`. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"territory_code":{"type":"string","pattern":"^(\\d{2}|\\d{5})?$","default":"","description":"Optional DIVIPOLA code: 5 digits for one municipality (e.g. `05001`, Medellín) or 2 digits for every municipality of a department (e.g. `05`, Antioquia)."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional exam year, 2010 to 2022. 0 returns every year."},"period":{"type":"string","pattern":"^(\\d{4}-[12])?$","default":"","description":"Optional exam period as `yyyy-1` (the first sitting of the year) or `yyyy-2` (the second), e.g. `2022-2`."},"stratum":{"type":"string","enum":["","1","2","3","4","5","6","sin_estrato","no_reportado"],"default":"","description":"Optional socioeconomic stratum of the student's home as the student reported it: `1` to `6`, `sin_estrato` (the home has none) or `no_reportado` (not answered)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"territory_code":"11001","period":"2022-2"}},{"id":"igac-transactions-search","name":"IGAC Property Transactions Search","method":"POST","path":"/co/igac-transactions/search/v1","url":"https://api.croma.run/co/igac-transactions/search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac-transactions","country":"Colombia","source":"IGAC Property Transactions","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the acts registered on Colombian property folios filed 2015-2023 (about 31 million annotations from the registry, published by IGAC): sales (act `125` compraventa), mortgages, embargoes, cancellations and others, each with the matrícula, municipality, zone, filing date, instrument and the value it declares. Requires `municipality_code` (DANE) or `registration_number` (matrícula, `<office>-<folio>`); narrow by `act_code`, `zone`, `year_from`/`year_to`, `min_value`/`max_value` (pesos) or `with_value`. Newest first. For a sale the value is the price in the deed, which can sit below the price agreed. Use `igac_transactions_price_statistics` for medians. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"municipality_code":{"type":"string","pattern":"^(\\d{5})?$","default":"","description":"Optional five-digit DANE code of the municipality, e.g. `17013` for Aguadas."},"registration_number":{"type":"string","pattern":"^(\\s*[0-9A-Za-z]{1,4}\\s*-\\s*\\d{1,8}\\s*)?$","default":"","description":"Optional matrícula inmobiliaria as `<registry office>-<folio>`, e.g. `001-1234567` or `50C-123456`."},"act_code":{"type":"integer","minimum":0,"maximum":9999,"default":0,"description":"Optional code of the registered act (naturaleza jurídica), e.g. `125` compraventa, `219` hipoteca abierta, `843` cancelación por voluntad de las partes. 0 means every act."},"zone":{"type":"string","enum":["","urban","rural"],"default":"","description":"Optional: `urban` or `rural`."},"year_from":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional first year of filing (radicación) to include, e.g. `2020`. 0 means no lower bound."},"year_to":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional last year of filing (radicación) to include, e.g. `2023`. 0 means no upper bound."},"min_value":{"type":"number","minimum":0,"default":0,"description":"Optional lowest declared value to include, in Colombian pesos, e.g. `100000000`. 0 means no lower bound."},"max_value":{"type":"number","minimum":0,"default":0,"description":"Optional highest declared value to include, in Colombian pesos. 0 means no upper bound."},"with_value":{"type":"boolean","default":false,"description":"Optional: `true` returns only annotations that declare a value."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"municipality_code":"17013","act_code":125,"year_from":2023}},{"id":"igac-transactions-folio-history","name":"IGAC Folio History","method":"POST","path":"/co/igac-transactions/folio-history/v1","url":"https://api.croma.run/co/igac-transactions/folio-history/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac-transactions","country":"Colombia","source":"IGAC Property Transactions","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve every act registered on one Colombian property folio filed 2015-2023, by its matrícula inmobiliaria (`<registry office>-<folio>`, e.g. `002-8032`), in the folio's order: sales with their declared price, mortgages, embargoes, cancellations, subdivisions. `found: false` when the folio had no act in those years or does not exist. No names of parties. Served by Croma (`as_of` says how current the data is).","required":["registration_number"],"request_schema":{"registration_number":{"type":"string","pattern":"^\\s*[0-9A-Za-z]{1,4}\\s*-\\s*\\d{1,8}\\s*$","description":"The matrícula inmobiliaria as `<registry office>-<folio>`, e.g. `001-1234567` or `50C-123456`. A numeric office may be written without its leading zeros (`1-1234567`)."}},"example_request":{"registration_number":"002-8032"}},{"id":"igac-transactions-price-statistics","name":"IGAC Property Price Statistics","method":"POST","path":"/co/igac-transactions/price-statistics/v1","url":"https://api.croma.run/co/igac-transactions/price-statistics/v1","docs_url":"https://docs.usecroma.com/guides/colombia/igac-transactions","country":"Colombia","source":"IGAC Property Transactions","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Declared values of the property acts registered in one Colombian municipality (`municipality_code`, DANE), per filing year (2015-2023), zone (`urban`/`rural`) and act: how many acts declared a value above zero, and their median, mean, lowest, highest and sum in pesos. Act `125` (compraventa) gives the median sale price written in deeds. Optionally one `act_code`, one `zone` and a `year_from`/`year_to` range. Prefer the median: a few acts declare whole-portfolio amounts. Served by Croma.","required":["municipality_code"],"request_schema":{"municipality_code":{"type":"string","pattern":"^\\d{5}$","description":"Five-digit DANE code of the municipality, e.g. `17013` for Aguadas or `52001` for Pasto."},"act_code":{"type":"integer","minimum":0,"maximum":9999,"default":0,"description":"Optional code of the registered act (naturaleza jurídica), e.g. `125` compraventa, `219` hipoteca abierta, `843` cancelación por voluntad de las partes. 0 means every act."},"zone":{"type":"string","enum":["","urban","rural"],"default":"","description":"Optional: `urban` or `rural`."},"year_from":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional first year of filing (radicación) to include, e.g. `2020`. 0 means no lower bound."},"year_to":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional last year of filing (radicación) to include, e.g. `2023`. 0 means no upper bound."}},"example_request":{"municipality_code":"17013","act_code":125}},{"id":"upra-land-prices-search","name":"UPRA Rural Land Prices Search","method":"POST","path":"/co/upra/land-prices-search/v1","url":"https://api.croma.run/co/upra/land-prices-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/upra","country":"Colombia","source":"UPRA Rural Land Prices","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search UPRA's map of commercial prices of rural agricultural land in Colombia: about 179,000 zones in 18 departments, each with its price range in pesos per hectare (`min_price_cop_per_ha`, `max_price_cop_per_ha`), the year of the study (2015-2023), its market category, area and polygon. Requires `municipality_code` (DANE, 5 digits) or `department_code` (2 digits); narrow by `min_price_per_hectare` (ranges starting at or above) and `max_price_per_hectare` (ranges ending at or below). Most expensive first. Not an appraisal of any one property. Find the zone under a coordinate with `upra_land_price_by_point`. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"municipality_code":{"type":"string","pattern":"^(\\d{5})?$","default":"","description":"Optional five-digit DANE code of the municipality, e.g. `17013` for Aguadas."},"department_code":{"type":"string","pattern":"^(\\d{2})?$","default":"","description":"Optional two-digit DANE code of the department, e.g. `73` for Tolima or `50` for Meta."},"min_price_per_hectare":{"type":"number","minimum":0,"default":0,"description":"Optional: only zones whose price range starts at or above this price per hectare, in Colombian pesos, e.g. `20000000`. 0 means no bound."},"max_price_per_hectare":{"type":"number","minimum":0,"default":0,"description":"Optional: only zones whose price range ends at or below this price per hectare, in Colombian pesos. 0 means no bound."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50); every result carries its geometry."}},"example_request":{"municipality_code":"73001"}},{"id":"upra-land-price-by-point","name":"UPRA Rural Land Price by Point","method":"POST","path":"/co/upra/land-price-by-point/v1","url":"https://api.croma.run/co/upra/land-price-by-point/v1","docs_url":"https://docs.usecroma.com/guides/colombia/upra","country":"Colombia","source":"UPRA Rural Land Prices","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Find the commercial price range of rural agricultural land at a point in Colombia (`latitude`, `longitude`, WGS84) from UPRA's land-market map: the zone that covers the point, with its price range in pesos per hectare, the year of the study, its market category, area and polygon. Land outside the market (urban zones, indigenous reserves, parks, páramos) comes back as a zone with `price_status: excluded` and the reason; `found: false` outside the 18 departments UPRA has studied and where no zone covers the point. Not an appraisal of any one property.","required":["latitude","longitude"],"request_schema":{"latitude":{"type":"number","minimum":-4.5,"maximum":13.5,"description":"Latitude of the point, decimal degrees (WGS84), within Colombia."},"longitude":{"type":"number","minimum":-82,"maximum":-66,"description":"Longitude of the point, decimal degrees (WGS84), within Colombia."}},"example_request":{"latitude":4.3,"longitude":-75}},{"id":"invima-registrations-search","name":"INVIMA Registrations Search","method":"POST","path":"/co/invima/registrations-search/v1","url":"https://api.croma.run/co/invima/registrations-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/invima","country":"Colombia","source":"INVIMA","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every sanitary registration (registro sanitario) and mandatory notification (NSO) INVIMA, Colombia's food and drug authority, has issued or let expire: about 385,000 across medicines, food and drinks, cosmetics, medical devices, diagnostic reagents, supplements, biologicals and more. Free text matches the product names, the holder and the companies and people in every role. Filter by `registration_number` (any spelling), `holder` (matched from the start), `product_group` (e.g. `MEDICAMENTOS`, `COSMETICOS`), `status` (`vigente` or `vencido`) and the expiry date (`expires_from`/`expires_to`). Each result carries the number, dates, holder, every product name and every party. Read one registration with `invima_registration`. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional search terms matched against the product names, the holder and the companies and people in every role of the registration."},"registration_number":{"type":"string","maxLength":60,"default":"","description":"Optional registration or notification number in any spelling, e.g. `INVIMA 2020M-0019848`, `2020M-0019848` or `NSO-PC-C 32.233 -VE`. Spaces, hyphens, dots and case are ignored."},"holder":{"type":"string","maxLength":200,"default":"","description":"Optional holder (titular) of the registration, matched from the start. Case and accents are ignored."},"product_group":{"type":"string","maxLength":40,"default":"","description":"Optional product group as INVIMA names it: `MEDICAMENTOS`, `ALIMENTOS`, `COSMETICOS`, `MEDICO QUIRURGICOS`, `REACTIVO DIAGNOSTICO`, `REACTIVOS IN VITRO`, `BEBIDAS ALCOHOLICAS`, `ASEO Y LIMPIEZA`, `SUPLEMENTO DIETARIO`, `BIOLOGICOS`, `HOMEOPATICOS`, `FITOTERAPEUTICO`, `ODONTOLOGICOS` or `PLAGUICIDAS`. Case and accents are ignored."},"status":{"type":"string","maxLength":60,"default":"","description":"Optional status as INVIMA states it: `vigente` (in force) or `vencido` (expired). Case and accents are ignored."},"expires_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"expires_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"query":"acetaminofen","product_group":"MEDICAMENTOS","status":"vigente"}},{"id":"invima-registration","name":"INVIMA Registration","method":"POST","path":"/co/invima/registration/v1","url":"https://api.croma.run/co/invima/registration/v1","docs_url":"https://docs.usecroma.com/guides/colombia/invima","country":"Colombia","source":"INVIMA","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one sanitary registration of INVIMA (Colombia) by its file number (expediente), the `id` of a search result, e.g. `20190868`: the registration number, status, issue and expiry dates, holder, product group, modality, every product name it covers and every company or person in a role on it (manufacturer, importer, packager, attorney, legal representative, pharmacist). Find a file number with `invima_registrations_search`.","required":["file_number"],"request_schema":{"file_number":{"type":"string","pattern":"^\\d{1,12}$","description":"The INVIMA file number (expediente) that identifies the registration, e.g. `20190868`."}},"example_request":{"file_number":"20190868"}},{"id":"invima-medicines-search","name":"INVIMA Medicines Search","method":"POST","path":"/co/invima/medicines-search/v1","url":"https://api.croma.run/co/invima/medicines-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/invima","country":"Colombia","source":"INVIMA","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every commercial presentation of every medicine registered with INVIMA (Colombia), about 163,000 with their CUM code (Código Único de Medicamento): the registration and its status, holder, ATC code, pharmaceutical form, active ingredients with concentration, routes, pack, whether the presentation is active, and the manufacturers and importers. Free text matches the name, the active ingredients, the holder and the ATC description. Filter by `active_ingredient` (exact, e.g. `ACETAMINOFEN`), `atc_code` (a code or a prefix such as `N02`), `registration_number`, `file_number`, `holder`, `status` (`vigente`, `vencido` and others), `cum_status` (`activo`/`inactivo`) and the expiry date. Read one presentation with `invima_medicine`. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional search terms matched against the medicine's name, its active ingredients, the holder and the ATC description."},"registration_number":{"type":"string","maxLength":60,"default":"","description":"Optional registration or notification number in any spelling, e.g. `INVIMA 2020M-0019848`, `2020M-0019848` or `NSO-PC-C 32.233 -VE`. Spaces, hyphens, dots and case are ignored."},"file_number":{"type":"string","pattern":"^(\\d{1,12})?$","default":"","description":"Optional INVIMA file number (expediente), e.g. `20042480`: every presentation of that one registration."},"active_ingredient":{"type":"string","maxLength":120,"default":"","description":"Optional active ingredient as INVIMA names it, e.g. `ACETAMINOFEN` or `AMOXICILINA TRIHIDRATO`. Exact match; case and accents are ignored."},"atc_code":{"type":"string","pattern":"^[A-Za-z0-9]{0,7}$","default":"","description":"Optional ATC code or prefix, e.g. `N02BE51` for a substance or `N02` for a whole group."},"holder":{"type":"string","maxLength":200,"default":"","description":"Optional holder (titular) of the registration, matched from the start. Case and accents are ignored."},"status":{"type":"string","maxLength":60,"default":"","description":"Optional status of the registration as INVIMA states it: `vigente`, `vencido`, `perdida fuerza ejec`, `cancelado`, `negado`, `suspendido`, `en tramite renov`, `temp. no comerc - vigente`, among others. Case and accents are ignored."},"cum_status":{"type":"string","enum":["","activo","inactivo"],"default":"","description":"Optional state of the presentation in the CUM: `activo` or `inactivo`."},"expires_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"expires_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"active_ingredient":"ACETAMINOFEN","status":"vigente","cum_status":"activo"}},{"id":"invima-medicine","name":"INVIMA Medicine","method":"POST","path":"/co/invima/medicine/v1","url":"https://api.croma.run/co/invima/medicine/v1","docs_url":"https://docs.usecroma.com/guides/colombia/invima","country":"Colombia","source":"INVIMA","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one presentation of a medicine registered with INVIMA (Colombia) by its CUM code (Código Único de Medicamento), the `id` of a search result, e.g. `20042480-41`: the registration and its status, holder, ATC code, pharmaceutical form, every active ingredient with its concentration, routes of administration, pack, whether the presentation is active and since when, and the manufacturers and importers. Find a CUM with `invima_medicines_search`.","required":["cum"],"request_schema":{"cum":{"type":"string","pattern":"^\\d{1,12}\\s*[^0-9A-Za-z]\\s*\\d{1,6}$","description":"The CUM code of the presentation: the file number and the sequence joined by a hyphen, e.g. `20042480-41`."}},"example_request":{"cum":"20042480-41"}},{"id":"mineducacion-indicators-search","name":"MinEducación Municipal Education Indicators","method":"POST","path":"/co/mineducacion/indicators-search/v1","url":"https://api.croma.run/co/mineducacion/indicators-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/mineducacion","country":"Colombia","source":"MinEducación","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Education indicators of Colombia's Ministry of Education for every municipality and school year since 2011 (about 15,700 municipality-years): population aged 5 to 16, enrollment rate, net and gross coverage, dropout, approval, failure and repetition, overall and by level (transición, primaria, secundaria, media), in percent. Filter by `territory_code` (5-digit DIVIPOLA municipality or 2-digit department), `year`, or match municipality and department names with `query`. Newest year first. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional words matched against the municipality and department names."},"territory_code":{"type":"string","pattern":"^(\\d{2}|\\d{5})?$","default":"","description":"Optional DIVIPOLA code: 5 digits for one municipality (e.g. `05001`, Medellín) or 2 digits for every municipality of a department (e.g. `05`, Antioquia)."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional school year, from 2011. 0 returns every year."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"territory_code":"05001"}},{"id":"procuraduria-disciplinary-records","name":"Procuraduría Disciplinary Records","method":"POST","path":"/co/procuraduria/disciplinary-records/v1","url":"https://api.croma.run/co/procuraduria/disciplinary-records/v1","docs_url":"https://docs.usecroma.com/guides/colombia/procuraduria","country":"Colombia","source":"Procuraduría","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Check a person or entity's antecedentes with the Procuraduría General de la Nación (disciplinary, penal, contractual, fiscal, and pérdida de investidura records from SIRI). `document_type` defaults to `CC`. Returns the verdict, the registered name, and the antecedente sections reproduced from the certificate.","required":["document_number"],"request_schema":{"document_type":{"type":"string","enum":["CC","CE","NIT","PEP","PPT"],"default":"CC","description":"Colombian document type. Defaults to `CC`."},"document_number":{"type":"string","minLength":3,"maxLength":30,"description":"Document number (alphanumeric with hyphens allowed)."}},"example_request":{"document_number":"1234567890"}},{"id":"samai-processes","name":"SAMAI Processes","method":"POST","path":"/co/samai/processes/v1","url":"https://api.croma.run/co/samai/processes/v1","docs_url":"https://docs.usecroma.com/guides/colombia/samai","country":"Colombia","source":"SAMAI / Consejo de Estado","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search live contentious-administrative processes (Consejo de Estado plus every Tribunal and Juzgado Administrativo) by party, radicado, or class, scoped to a corporación. Returns one page of matches with the reporting magistrate, class, filing date, parties and the official detail link. A `parte` or `clase` search requires `corporacion`: use 1100103 for the Consejo de Estado, or get a Tribunal or Juzgado code from SAMAI Corporaciones first. A `radicado` search derives the corporación from the radicado when none is given.","required":["query"],"request_schema":{"search_type":{"type":"string","enum":["radicado","clase","parte"],"default":"parte","description":"Search by `parte` (party name), `radicado` (case number), or `clase` (process class)."},"query":{"type":"string","minLength":2,"maxLength":200,"description":"The value to search for: a party name (`parte`), a radicado, or a process class."},"corporacion":{"type":"string","default":"","description":"Corporación (despacho) code to scope the search, e.g. `1100103` for the Consejo de Estado. Required for party/class searches; for a radicado search it is inferred when omitted. List codes with the corporaciones catalog."},"section":{"type":"string","maxLength":20,"default":"","description":"Optional sección (chamber) code to narrow the search."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Results per page (1-50)."}},"example_request":{"search_type":"parte","query":"BANCOLOMBIA","corporacion":"1100103"}},{"id":"samai-corporaciones","name":"SAMAI Corporaciones","method":"POST","path":"/co/samai/corporaciones/v1","url":"https://api.croma.run/co/samai/corporaciones/v1","docs_url":"https://docs.usecroma.com/guides/colombia/samai","country":"Colombia","source":"SAMAI / Consejo de Estado","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Every corporación (despacho) SAMAI exposes, with its code and name. A code scopes a process search.","required":[],"request_schema":{},"example_request":{}},{"id":"samai-secciones","name":"SAMAI Secciones","method":"POST","path":"/co/samai/secciones/v1","url":"https://api.croma.run/co/samai/secciones/v1","docs_url":"https://docs.usecroma.com/guides/colombia/samai","country":"Colombia","source":"SAMAI / Consejo de Estado","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"The secciones (salas) inside one corporación, with their codes and names.","required":["corporacion"],"request_schema":{"corporacion":{"type":"string","pattern":"^\\d{5,9}$","description":"Corporación code (from the corporaciones catalog)."}},"example_request":{"corporacion":"1100103"}},{"id":"samai-rulings-search","name":"SAMAI Rulings Search","method":"POST","path":"/co/samai-rulings/search/v1","url":"https://api.croma.run/co/samai-rulings/search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/samai-rulings","country":"Colombia","source":"SAMAI / Consejo de Estado","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every ruling of the Consejo de Estado dated since December 2021 that its relatoría has titled: sentencias, autos, aclaraciones and salvamentos de voto and conceptos, each with the relatoría's headnotes (descriptors, legal problem and answer, thesis, formal sources, notes), its full text, its document (PDF, or Word for some of the oldest) and the case's page on the court's own site. Free text matches the headnotes, the case number, the parties and the full text. Filter by `chamber`, `type`, `year`, `registration_number` (the radicado), `reporting_judge` (the consejero ponente), `plaintiff`, `defendant` and the ruling date (`from_date`/`to_date`). Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the ruling's headnotes (descriptors, legal problem, thesis, sources, relatoría note), its case number, its parties and its full text."},"chamber":{"type":"string","maxLength":120,"default":"","description":"Optional chamber (sección or sala), matched from the start of its name: `Sección Tercera` also matches its subsecciones. Case and accents are ignored."},"type":{"type":"string","maxLength":80,"default":"","description":"Optional kind of ruling, matched from the start of its name: `Sentencia`, `Auto` (every kind of auto), `Salvamento voto`, `Aclaración voto`. Case and accents are ignored."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year of the ruling date. 0 searches every year."},"registration_number":{"type":"string","maxLength":40,"default":"","description":"Optional 23-digit case number (radicado). Spaces, dots and dashes are ignored."},"reporting_judge":{"type":"string","maxLength":120,"default":"","description":"Optional consejero ponente, by full name as it appears in `reporting_judges`. Case and accents are ignored."},"plaintiff":{"type":"string","maxLength":200,"default":"","description":"Optional plaintiff, matched from the start of the name as the court lists it. Case and accents are ignored."},"defendant":{"type":"string","maxLength":200,"default":"","description":"Optional defendant, matched from the start of the name as the court lists it. Case and accents are ignored."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"reparación directa","chamber":"Sección Tercera"}},{"id":"samai-rulings-ruling","name":"SAMAI Ruling","method":"POST","path":"/co/samai-rulings/ruling/v1","url":"https://api.croma.run/co/samai-rulings/ruling/v1","docs_url":"https://docs.usecroma.com/guides/colombia/samai-rulings","country":"Colombia","source":"SAMAI / Consejo de Estado","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one ruling of the Consejo de Estado by its `id` (from a search result): the relatoría's headnotes, the case data, the parties, the ruling's document (PDF, or Word for some of the oldest) and the case's page on the court's own site, with the full text read a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false. Served by Croma (`as_of` says how current the data is).","required":["ruling_id"],"request_schema":{"ruling_id":{"type":"string","pattern":"^\\s*[0-9A-Fa-f]{64}\\s*$","description":"The ruling's `id` from a search result: the 64-character hexadecimal certificate of its document."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"ruling_id":"8C5E75723C249F020E54B1D2B2BCB0735566D537789B23F23B1373B33F24F21F"}},{"id":"secop-process","name":"SECOP Process by Notice","method":"POST","path":"/co/secop/process/v1","url":"https://api.croma.run/co/secop/process/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Resolve a Colombian public-procurement process (SECOP II) by its OpportunityDetail noticeUID and return the process header, the per-provider award list, and every awarded contract: providers, documents, values, dates, and execution amounts. Sourced from Colombia Compra Eficiente's open data. `found: false` when no process matches the noticeUID.","required":["notice_uid"],"request_schema":{"notice_uid":{"type":"string","pattern":"^CO1\\.NTC\\.\\d{3,}$","description":"SECOP OpportunityDetail noticeUID, e.g. \"CO1.NTC.9458505\"."}},"example_request":{"notice_uid":"CO1.NTC.9458505"}},{"id":"secop-contracts-by-provider","name":"SECOP Contracts by Provider","method":"POST","path":"/co/secop/contracts-by-provider/v1","url":"https://api.croma.run/co/secop/contracts-by-provider/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"live","monitorable":false,"description":"List the public-procurement contracts (SECOP II) awarded to one provider by cédula or NIT, across all contracting entities: the contractor profile (who hired them, values, status, dates). Optional filters: contracting-entity NIT and a sign-date window (`from_date`/`to_date`). Pages of 500, newest first (`page`, 1-based); `capped: true` means the page is full and later pages may exist.","required":["document_number"],"request_schema":{"document_number":{"type":"string","pattern":"^[0-9A-Za-z.\\-]{4,24}$","description":"Provider cédula or NIT. Dots and a trailing verification digit are optional: `900195855`, `900195855-1` and `900.195.855-1` all match the same contractor."},"entity_nit":{"type":"string","pattern":"^(\\d{4,15})?$","default":"","description":"Optional contracting-entity NIT filter (digits, no verification digit)."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"document_number":"79372917"},"deprecated":{"since":"2026-08-30","sunset":"2026-12-01","successor_url":"https://api.croma.run/co/secop/contracts-search/v1"}},{"id":"secop-processes-by-entity","name":"SECOP Processes by Entity","method":"POST","path":"/co/secop/processes-by-entity/v1","url":"https://api.croma.run/co/secop/processes-by-entity/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"live","monitorable":false,"description":"List the procurement processes (SECOP II) published by one contracting entity (by NIT), optionally within a publication-date window. The audit population for an entity. Returns lean summaries (drill into one with `secop-process`). Pages of 500, newest first (`page`, 1-based); `capped: true` means the page is full and later pages may exist.","required":["document_number"],"request_schema":{"document_number":{"type":"string","minLength":4,"maxLength":15,"pattern":"^\\d{4,15}$","description":"Colombian NIT (numeric, no verification digit). 4-15 digits."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"document_number":"899999061","from_date":"2026-01-01"},"deprecated":{"since":"2026-08-30","sunset":"2026-12-01","successor_url":"https://api.croma.run/co/secop/processes-search/v1"}},{"id":"secop-contract","name":"SECOP Contract by ID","method":"POST","path":"/co/secop/contract/v1","url":"https://api.croma.run/co/secop/contract/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Resolve one electronic contract (SECOP II) by its contract id and return the full contract record plus its satellite history: registered additions/modifications, insurance policies (garantías) with insurer and validity, and the delivery plan with planned vs actual progress. `found: false` when no contract matches the id.","required":["contract_id"],"request_schema":{"contract_id":{"type":"string","pattern":"^CO1\\.PCCNTR\\.\\d{3,}$","description":"SECOP electronic contract id, e.g. \"CO1.PCCNTR.6794799\"."}},"example_request":{"contract_id":"CO1.PCCNTR.6794799"}},{"id":"secop-sanctions-by-provider","name":"SECOP Sanctions by Provider","method":"POST","path":"/co/secop/sanctions-by-provider/v1","url":"https://api.croma.run/co/secop/sanctions-by-provider/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"live","monitorable":false,"description":"List the fines and sanctions (multas y sanciones) recorded against one state contractor by cédula or NIT: sanctioning entity, resolution number, value, and the dates the sanction was published and became final. A direct adverse signal for counterparty screening, from Colombia Compra Eficiente's open data.","required":["document_number"],"request_schema":{"document_number":{"type":"string","pattern":"^[0-9A-Za-z.\\-]{4,24}$","description":"Provider cédula or NIT. Dots and a trailing verification digit are optional: `900195855`, `900195855-1` and `900.195.855-1` all match the same contractor."}},"example_request":{"document_number":"1067811412"},"deprecated":{"since":"2026-08-30","sunset":"2026-12-01","successor_url":"https://api.croma.run/co/secop/sanctions-search/v1"}},{"id":"secop-processes-search","name":"SECOP Processes Search","method":"POST","path":"/co/secop/processes-search/v1","url":"https://api.croma.run/co/secop/processes-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every Colombian public procurement process from SECOP II (2015 onward) and SECOP I (2004 onward) in one place. Full-text over what is being bought, plus filters on the buying entity's NIT, department, modality, contract type, status, UNSPSC category, year, publication-date range, estimated value and whether the process was awarded. Answers in milliseconds and covers both systems at once; use `secop-process` when you have a noticeUID and want one process with its awards and contracts.","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the free text of the record (what is being bought, the entity and the supplier). Leave empty to filter without searching."},"platform":{"type":"string","enum":["any","secop_i","secop_ii"],"default":"any","description":"Restrict to one system: `secop_ii` (the transactional platform, 2015 onward), `secop_i` (the publication register, 2004 onward), or `any` for both."},"entity_nit":{"type":"string","maxLength":20,"default":"","description":"Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records)."},"department":{"type":"string","maxLength":80,"default":"","description":"Optional department of the contracting entity, as SECOP writes it (`Antioquia`, `Bogotá D.C.`, ...). Empty for the whole country."},"modality":{"type":"string","maxLength":120,"default":"","description":"Optional modalidad de contratación, exactly as SECOP writes it (`Contratación directa`, `Licitación pública`, `Mínima cuantía`, ...). Empty for every modality."},"contract_type":{"type":"string","maxLength":120,"default":"","description":"Optional tipo de contrato, exactly as SECOP writes it (`Prestación de servicios`, `Obra`, `Suministros`, ...). Empty for every type."},"status":{"type":"string","maxLength":120,"default":"","description":"Optional estado, exactly as SECOP writes it (`Adjudicado`, `Celebrado`, `En ejecución`, `Terminado`, ...). Empty for every status."},"unspsc_code":{"type":"string","maxLength":40,"default":"","description":"Optional main UNSPSC category code of the purchase (`V1.80101500`). Empty for every category."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional calendar year. 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"min_value":{"type":"number","minimum":0,"default":0,"description":"Optional lower bound on the amount, in COP. 0 means no lower bound."},"max_value":{"type":"number","minimum":0,"default":0,"description":"Optional upper bound on the amount, in COP. 0 means no upper bound."},"sort":{"type":"string","enum":["recent","oldest","value_desc","value_asc"],"default":"recent","description":"Order of the results: `recent` (newest first, the default), `oldest`, `value_desc` (largest amount first) or `value_asc`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."},"awarded":{"type":"string","enum":["any","yes","no"],"default":"any","description":"Restrict to processes that reached an award (`yes`), that did not (`no`), or `any`. Processes whose outcome the source does not state are excluded by `yes` and `no` alike."}},"example_request":{"query":"recolección de residuos","year":2025,"per_page":20}},{"id":"secop-contracts-search","name":"SECOP Contracts Search","method":"POST","path":"/co/secop/contracts-search/v1","url":"https://api.croma.run/co/secop/contracts-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every contract the Colombian state has signed, across SECOP II (2015 onward) and SECOP I (2004 onward), in one shape. Full-text over the contract object and the parties, plus filters on the contractor's document (NIT or cédula, in any of the spellings SECOP prints), the cédula of the contractor's legal representative, the entity NIT, department, sector, contract type, modality, status, UNSPSC category, year, signature-date range and amount. This is the endpoint for \"everything this company or person has contracted with the Colombian state\".","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the free text of the record (what is being bought, the entity and the supplier). Leave empty to filter without searching."},"platform":{"type":"string","enum":["any","secop_i","secop_ii"],"default":"any","description":"Restrict to one system: `secop_ii` (the transactional platform, 2015 onward), `secop_i` (the publication register, 2004 onward), or `any` for both."},"entity_nit":{"type":"string","maxLength":20,"default":"","description":"Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records)."},"department":{"type":"string","maxLength":80,"default":"","description":"Optional department of the contracting entity, as SECOP writes it (`Antioquia`, `Bogotá D.C.`, ...). Empty for the whole country."},"modality":{"type":"string","maxLength":120,"default":"","description":"Optional modalidad de contratación, exactly as SECOP writes it (`Contratación directa`, `Licitación pública`, `Mínima cuantía`, ...). Empty for every modality."},"contract_type":{"type":"string","maxLength":120,"default":"","description":"Optional tipo de contrato, exactly as SECOP writes it (`Prestación de servicios`, `Obra`, `Suministros`, ...). Empty for every type."},"status":{"type":"string","maxLength":120,"default":"","description":"Optional estado, exactly as SECOP writes it (`Adjudicado`, `Celebrado`, `En ejecución`, `Terminado`, ...). Empty for every status."},"unspsc_code":{"type":"string","maxLength":40,"default":"","description":"Optional main UNSPSC category code of the purchase (`V1.80101500`). Empty for every category."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional calendar year. 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"min_value":{"type":"number","minimum":0,"default":0,"description":"Optional lower bound on the amount, in COP. 0 means no lower bound."},"max_value":{"type":"number","minimum":0,"default":0,"description":"Optional upper bound on the amount, in COP. 0 means no upper bound."},"sort":{"type":"string","enum":["recent","oldest","value_desc","value_asc"],"default":"recent","description":"Order of the results: `recent` (newest first, the default), `oldest`, `value_desc` (largest amount first) or `value_asc`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."},"provider_document":{"type":"string","maxLength":20,"default":"","description":"Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records)."},"legal_rep_document":{"type":"string","maxLength":20,"default":"","description":"Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records)."},"sector":{"type":"string","maxLength":80,"default":"","description":"Optional sector of the contracting entity (`Salud y Protección Social`, `Educación Nacional`, ...). Published on SECOP II contracts only. Empty for every sector."}},"example_request":{"provider_document":"900195855","sort":"value_desc","per_page":20}},{"id":"secop-modifications-search","name":"SECOP Contract Modifications Search","method":"POST","path":"/co/secop/modifications-search/v1","url":"https://api.croma.run/co/secop/modifications-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the changes made to Colombian public contracts after signature: additions, extensions and other modifications, with how much money and how many days each one added. Filter by contract id, platform, year, registration-date range and a minimum added amount, and sort by amount to find the contracts that grew the most after they were awarded.","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the free text of the record (what is being bought, the entity and the supplier). Leave empty to filter without searching."},"contract_id":{"type":"string","maxLength":120,"default":"","description":"Optional contract id from a search result (`id` on a contract). Empty searches every contract."},"platform":{"type":"string","enum":["any","secop_i","secop_ii"],"default":"any","description":"Restrict to one system: `secop_ii` (the transactional platform, 2015 onward), `secop_i` (the publication register, 2004 onward), or `any` for both."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional calendar year. 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"min_value":{"type":"number","minimum":0,"default":0,"description":"Optional lower bound on the amount, in COP. 0 means no lower bound."},"sort":{"type":"string","enum":["recent","oldest","value_desc","value_asc"],"default":"recent","description":"Order of the results: `recent` (newest first, the default), `oldest`, `value_desc` (largest amount first) or `value_asc`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"min_value":1000000000,"sort":"value_desc","per_page":20}},{"id":"secop-suppliers-search","name":"SECOP Suppliers Search","method":"POST","path":"/co/secop/suppliers-search/v1","url":"https://api.croma.run/co/secop/suppliers-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the suppliers registered on SECOP II: who they are, the document they registered under, what category they sell in, where they are, and whether the account is still active. Use it to resolve a company name to its NIT before searching contracts, or to check that a contractor is a registered supplier at all.","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the free text of the record (what is being bought, the entity and the supplier). Leave empty to filter without searching."},"document":{"type":"string","maxLength":20,"default":"","description":"Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records)."},"department":{"type":"string","maxLength":80,"default":"","description":"Optional department of the contracting entity, as SECOP writes it (`Antioquia`, `Bogotá D.C.`, ...). Empty for the whole country."},"unspsc_code":{"type":"string","maxLength":40,"default":"","description":"Optional main UNSPSC category code of the purchase (`V1.80101500`). Empty for every category."},"active":{"type":"string","enum":["any","yes","no"],"default":"any","description":"Restrict to active supplier accounts (`yes`), inactive ones (`no`), or `any`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"query":"constructora","department":"Antioquia","per_page":20}},{"id":"secop-bidders-search","name":"SECOP Bidders Search","method":"POST","path":"/co/secop/bidders-search/v1","url":"https://api.croma.run/co/secop/bidders-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search who bid on Colombian procurement processes, including the bidders that lost. Filter by process id or by a bidder's document to see either everyone who competed for one contract, or every process a company has bid on. This is the only published view of how contested a tender actually was.","required":[],"request_schema":{"process_id":{"type":"string","maxLength":120,"default":"","description":"Optional process id from a search result (`id` on a process, or `process_id` on a bidder). Empty searches every process."},"bidder_document":{"type":"string","maxLength":20,"default":"","description":"Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records)."},"platform":{"type":"string","enum":["any","secop_i","secop_ii"],"default":"any","description":"Restrict to one system: `secop_ii` (the transactional platform, 2015 onward), `secop_i` (the publication register, 2004 onward), or `any` for both."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional calendar year. 0 searches every year."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"bidder_document":"900195855","per_page":20}},{"id":"secop-sanctions-search","name":"SECOP Sanctions Search","method":"POST","path":"/co/secop/sanctions-search/v1","url":"https://api.croma.run/co/secop/sanctions-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the fines and sanctions Colombian public entities have imposed on their contractors: who was sanctioned, under which contract, for how much, and when the sanction became final. Filter by the contractor's document, the entity's NIT, the year or a publication-date range.","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the free text of the record (what is being bought, the entity and the supplier). Leave empty to filter without searching."},"provider_document":{"type":"string","maxLength":20,"default":"","description":"Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records)."},"entity_nit":{"type":"string","maxLength":20,"default":"","description":"Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records)."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional calendar year. 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"query":"incumplimiento","per_page":20}},{"id":"secop-plans-search","name":"SECOP Annual Procurement Plans Search","method":"POST","path":"/co/secop/plans-search/v1","url":"https://api.croma.run/co/secop/plans-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the Plan Anual de Adquisiciones each Colombian public entity publishes: the budget it expects to spend that year and the thresholds it will buy under, published before it buys any of it. Filter by entity NIT, department, year or platform to see what an entity intends to procure rather than what it already has.","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the free text of the record (what is being bought, the entity and the supplier). Leave empty to filter without searching."},"department":{"type":"string","maxLength":80,"default":"","description":"Optional department of the contracting entity, as SECOP writes it (`Antioquia`, `Bogotá D.C.`, ...). Empty for the whole country."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional calendar year. 0 searches every year."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"year":2026,"per_page":20}},{"id":"secop-profile","name":"SECOP Profile","method":"POST","path":"/co/secop/profile/v1","url":"https://api.croma.run/co/secop/profile/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Everything Colombian public procurement knows about one NIT or cédula, in a single call: the SECOP II supplier account if there is one, how many contracts it has signed and the largest of them, how many awards it has won, how many processes it has bid on, every sanction against it, and, when the document belongs to a public entity, what it has bought. Start here for any question about a company or a person; the searches are for paging past what this returns.","required":["document"],"request_schema":{"document":{"type":"string","pattern":"^[0-9A-Za-z.\\-]{4,24}$","description":"Provider cédula or NIT. Dots and a trailing verification digit are optional: `900195855`, `900195855-1` and `900.195.855-1` all match the same contractor."},"per_section":{"type":"integer","minimum":1,"maximum":25,"default":5,"description":"How many records each list in the response holds (1-25). The counts beside the lists are exact totals regardless of this."}},"example_request":{"document":"900195855"}},{"id":"secop-awards-search","name":"SECOP Awards Search","method":"POST","path":"/co/secop/awards-search/v1","url":"https://api.croma.run/co/secop/awards-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every award made on a Colombian procurement process on SECOP II: which provider won, how much of the award was theirs, and when. The processes dataset keeps one row per process, so a framework agreement that awarded thousands of providers shows only one there; this is where all of them are. Filter by the provider's document to see everything a company has been awarded, as opposed to what it went on to sign.","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the free text of the record (what is being bought, the entity and the supplier). Leave empty to filter without searching."},"provider_document":{"type":"string","maxLength":20,"default":"","description":"Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records)."},"entity_nit":{"type":"string","maxLength":20,"default":"","description":"Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records)."},"process_id":{"type":"string","maxLength":120,"default":"","description":"Optional process id from a search result (`id` on a process, or `process_id` on a bidder). Empty searches every process."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional calendar year. 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"min_value":{"type":"number","minimum":0,"default":0,"description":"Optional lower bound on the amount, in COP. 0 means no lower bound."},"max_value":{"type":"number","minimum":0,"default":0,"description":"Optional upper bound on the amount, in COP. 0 means no upper bound."},"sort":{"type":"string","enum":["recent","oldest","value_desc","value_asc"],"default":"recent","description":"Order of the results: `recent` (newest first, the default), `oldest`, `value_desc` (largest amount first) or `value_asc`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"provider_document":"900195855","sort":"value_desc","per_page":20}},{"id":"secop-process-record","name":"SECOP Process Record","method":"POST","path":"/co/secop/process-record/v1","url":"https://api.croma.run/co/secop/process-record/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Read one procurement process by the platform-prefixed `id` a SECOP search returned (e.g. `secop_ii:CO1.REQ.1234567`). Works for SECOP I and SECOP II alike and answers in milliseconds; for the live view of a SECOP II process with its per-provider awards and awarded contracts attached, use `secop-process` with the noticeUID instead.","required":["record_id"],"request_schema":{"record_id":{"type":"string","minLength":3,"maxLength":120,"description":"Record id from a SECOP search result (`id`), platform-prefixed: e.g. `secop_ii:CO1.PCCNTR.4168447`, `secop_i:20-11-10442331`."}},"example_request":{"record_id":"secop_ii:CO1.REQ.1234567"}},{"id":"secop-contract-record","name":"SECOP Contract Record","method":"POST","path":"/co/secop/contract-record/v1","url":"https://api.croma.run/co/secop/contract-record/v1","docs_url":"https://docs.usecroma.com/guides/colombia/secop","country":"Colombia","source":"SECOP","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Read one contract by the platform-prefixed `id` a SECOP search returned (e.g. `secop_ii:CO1.PCCNTR.4168447`). Works for SECOP I and SECOP II alike and answers in milliseconds; for the live view of a SECOP II contract with its additions, guarantees and delivery plan attached, use `secop-contract` with the contract id instead.","required":["record_id"],"request_schema":{"record_id":{"type":"string","minLength":3,"maxLength":120,"description":"Record id from a SECOP search result (`id`), platform-prefixed: e.g. `secop_ii:CO1.PCCNTR.4168447`, `secop_i:20-11-10442331`."}},"example_request":{"record_id":"secop_ii:CO1.PCCNTR.4168447"}},{"id":"simit-account-status","name":"SIMIT Account Status","method":"POST","path":"/co/simit/account-status/v1","url":"https://api.croma.run/co/simit/account-status/v1","docs_url":"https://docs.usecroma.com/guides/colombia/simit","country":"Colombia","source":"SIMIT","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up a SIMIT (Sistema Integrado de Información sobre Multas y Sanciones por Infracciones de Tránsito) account status by vehicle plate or by a person's identification number. Returns outstanding comparendos and multas (each with the offending party, infraction codes and descriptions, traffic authority, department, amounts, and the discount/payment projections), the account totals, any payment agreements (acuerdos de pago), and driving courses (cursos viales). `is_plate` reports whether the value was matched as a plate. `clear: true` means paz y salvo (nothing outstanding).","required":["document_number"],"request_schema":{"document_number":{"type":"string","minLength":4,"maxLength":20,"pattern":"^[A-Za-z0-9]{4,20}$","description":"Vehicle plate (e.g. `ABC123`) or identification number to look up."}},"example_request":{"document_number":"ABC123"}},{"id":"superfinanciera-regulations-search","name":"Superfinanciera Regulations Search","method":"POST","path":"/co/superfinanciera/regulations-search/v1","url":"https://api.croma.run/co/superfinanciera/regulations-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/superfinanciera","country":"Colombia","source":"Superfinanciera","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every Circular Externa, Carta Circular and Resolución the Superintendencia Financiera de Colombia has issued since 2005, across all kinds and years at once. Filter by free text over the official description, by `kind`, `year`, exact `number` (with or without leading zeros), the `bulletin` it was published in, and the date it was issued (`issued_from`/`issued_to`). Results come back newest first with the Superintendencia's own description of what each act does and a link to the act itself. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the official description of the act and its number."},"kind":{"type":"string","enum":["any","circular_externa","carta_circular","resolucion"],"default":"any","description":"Kind of act: `circular_externa` (binding instructions), `carta_circular` (informative), `resolucion` (administrative act), or `any`."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year the act was issued (2005 or later). 0 searches every year."},"number":{"type":"string","maxLength":40,"default":"","description":"Optional act number, with or without leading zeros (`7`, `007`, `1195`). A few acts carry a written number, e.g. `Conjunta 002`."},"bulletin":{"type":"string","maxLength":20,"default":"","description":"Optional issue number of the Boletín del Ministerio de Hacienda y Crédito Público the act was published in."},"issued_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"issued_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"riesgo de crédito","kind":"circular_externa"}},{"id":"superfinanciera-regulation","name":"Superfinanciera Regulation","method":"POST","path":"/co/superfinanciera/regulation/v1","url":"https://api.croma.run/co/superfinanciera/regulation/v1","docs_url":"https://docs.usecroma.com/guides/colombia/superfinanciera","country":"Colombia","source":"Superfinanciera","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one act of the Superintendencia Financiera de Colombia by its `regulation_id` from the search results (e.g. `ce:2026:7` for Circular Externa 007 de 2026, `cc:2026:56`, `res:2026:1195`), with its official description, the date it was issued, the bulletin it was published in and a link to the act.","required":["regulation_id"],"request_schema":{"regulation_id":{"type":"string","minLength":3,"maxLength":80,"description":"Act identifier from the search results (`id`), e.g. `ce:2026:7`, `cc:2026:56`, `res:2026:1195`."}},"example_request":{"regulation_id":"ce:2026:7"}},{"id":"superfinanciera-complaints","name":"Superfinanciera Complaints","method":"POST","path":"/co/superfinanciera/complaints/v1","url":"https://api.croma.run/co/superfinanciera/complaints/v1","docs_url":"https://docs.usecroma.com/guides/colombia/superfinanciera","country":"Colombia","source":"Superfinanciera","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Return the action history of a specific jurisdictional complaint filed against a person or entity at Colombia's Superfinanciera.","required":["document_number","filing_number"],"request_schema":{"document_number":{"type":"string","pattern":"^\\d{5,20}$","description":"Document or NIT of the complainant."},"filing_number":{"type":"string","pattern":"^\\d{10}$","description":"10-digit filing number (numeroRadicacion) assigned by Superfinanciera when the complaint was filed."}},"example_request":{"document_number":"1234567890","filing_number":"2024051440"}},{"id":"superfinanciera-doctrine-search","name":"Superfinanciera Doctrine Search","method":"POST","path":"/co/superfinanciera-doctrine/search/v1","url":"https://api.croma.run/co/superfinanciera-doctrine/search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/superfinanciera-doctrine","country":"Colombia","source":"Superfinanciera Doctrina","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the Superintendencia Financiera de Colombia's doctrine and case-law catalog: every concepto it has issued since 1994 (the Superintendencia Bancaria's before 2005), every ruling of its Delegatura para Funciones Jurisdiccionales, and the high-court rulings it catalogues as jurisprudencia financiera. Free text matches the number, case file number, title, summary, subject descriptors and full text. Filter by `collection`, `year`, `number`, `registration_number` (expediente or radicado), `issuer`, `topic`, the date (`from_date`/`to_date`) and `text_status`. Each result links to its entry in the Superintendencia's catalog and to the document. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the document's number, case file number, title, summary, topics and full text."},"collection":{"type":"string","enum":["any","concept","jurisdictional_ruling","financial_case_law","other"],"default":"any","description":"Part of the catalog: `concept` (conceptos, the SFC's doctrine), `jurisdictional_ruling` (fallos of its Delegatura para Funciones Jurisdiccionales), `financial_case_law` (high-court sentencias the SFC catalogues as jurisprudencia financiera), `other`, or `any`."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year the SFC files the document under (the year it was issued, in almost every case). 0 searches every year."},"number":{"type":"string","maxLength":60,"default":"","description":"Optional number of the concepto, fallo or sentencia as the SFC prints it (`2020311455-001`, `2017-1900`, `T-123`). Case, spaces and leading zeros are ignored."},"registration_number":{"type":"string","maxLength":80,"default":"","description":"Optional case file number (expediente or radicado) of a fallo or sentencia, e.g. `2019123456`. Case, spaces and punctuation are ignored."},"issuer":{"type":"string","maxLength":160,"default":"","description":"Optional issuer, matched from the start of the name: `superintendencia financiera` (its Delegatura para Funciones Jurisdiccionales included), `superintendencia bancaria`, `corte constitucional`, `consejo de estado`, `corte suprema`. Case and accents are ignored."},"topic":{"type":"string","maxLength":160,"default":"","description":"Optional subject descriptor, as the SFC publishes it in `topics`, e.g. `PROTECCIÓN AL CONSUMIDOR FINANCIERO`. Case and accents are ignored."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"text_status":{"type":"string","enum":["any","extracted","no_text_layer","audio","dead_link","withdrawn","no_document"],"default":"any","description":"Optional state of the document's text: `extracted` (the full text is here), `no_text_layer` (a scan or a format with no text to read), `audio` (a hearing published as a recording), `dead_link` (the SFC's link leads to no document), `withdrawn`, `no_document`, or `any`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"consumidor financiero","collection":"concept"}},{"id":"superfinanciera-doctrine-entry","name":"Superfinanciera Doctrine Entry","method":"POST","path":"/co/superfinanciera-doctrine/entry/v1","url":"https://api.croma.run/co/superfinanciera-doctrine/entry/v1","docs_url":"https://docs.usecroma.com/guides/colombia/superfinanciera-doctrine","country":"Colombia","source":"Superfinanciera Doctrina","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one document of the Superintendencia Financiera de Colombia's doctrine and case-law catalog by the `id` from the search results: its full text where the document carries text, the SFC's summary and subject descriptors, the number, the date, the issuer, the case file number, and links to its entry in the catalog and to the document itself. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.","required":["entry_id"],"request_schema":{"entry_id":{"type":"string","pattern":"^\\s*\\d{1,9}\\s*$","description":"Catalog identifier from the search results (`id`), e.g. `18717`."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"entry_id":"1"}},{"id":"simev-shareholders","name":"SIMEV Issuer Shareholders","method":"POST","path":"/co/simev/shareholders/v1","url":"https://api.croma.run/co/simev/shareholders/v1","docs_url":"https://docs.usecroma.com/guides/colombia/simev","country":"Colombia","source":"SIMEV","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Principal shareholders a Colombian securities issuer reported to the Superintendencia Financiera, by NIT: each holder's identity document, name, nationality, shares and share per class (ordinary, privileged, preferred) at a June or December cut-off, plus the issuer's share register summary. Latest cut-off by default, or a given one; every cut-off on record is listed. Covers the roughly 110 registered issuers with a published list, most of the country's banks among them. Served by Croma (`as_of` says how current the data is), brought up to date weekly.","required":["document_number"],"request_schema":{"document_number":{"type":"string","minLength":4,"maxLength":15,"pattern":"^\\d{4,15}$","description":"Colombian NIT (numeric, no verification digit). 4-15 digits."},"cutoff_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."}},"example_request":{"document_number":"860002964"}},{"id":"adres-affiliation-status","name":"ADRES Health Affiliation Status","method":"POST","path":"/co/adres/affiliation-status/v1","url":"https://api.croma.run/co/adres/affiliation-status/v1","docs_url":"https://docs.usecroma.com/guides/colombia/adres","country":"Colombia","source":"ADRES","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up a person's affiliation to the Colombian health system (BDUA): the entities (EPS) they are or were affiliated to, the régimen (contributivo/subsidiado), affiliation dates, and affiliate type. `document_type` defaults to `CC`. Returns `found: false` when the document is not registered in BDUA.","required":["document_number"],"request_schema":{"document_type":{"type":"string","enum":["CC","TI","CE","RC","PA","PEP","PPT"],"default":"CC","description":"Colombian document type. Defaults to `CC`."},"document_number":{"type":"string","minLength":3,"maxLength":30,"description":"Document number (alphanumeric with hyphens allowed)."}},"example_request":{"document_type":"CC","document_number":"1234567890"}},{"id":"dnp-social-classification","name":"DNP Social Classification (Sisbén IV and RUI)","method":"POST","path":"/co/dnp/social-classification/v1","url":"https://api.croma.run/co/dnp/social-classification/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dnp","country":"Colombia","source":"Departamento Nacional de Planeación (DNP)","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up a person's socioeconomic classification in Colombia by document, live from the DNP: the Sisbén IV group (`A1` to `D21`, with its category and label) and the RUI income classification with the registered name, sex, age and municipality. `document_type` defaults to `CC`. Returns `found: false` when the person has neither.","required":["document_number"],"request_schema":{"document_type":{"type":"string","enum":["CC","TI","CE","RC","PA","PEP","PPT"],"default":"CC","description":"Colombian document type. Defaults to `CC`."},"document_number":{"type":"string","minLength":3,"maxLength":30,"description":"Document number (alphanumeric with hyphens allowed)."}},"example_request":{"document_type":"CC","document_number":"1234567890"}},{"id":"dnp-sisben-offices","name":"DNP Sisbén Offices","method":"POST","path":"/co/dnp/sisben-offices/v1","url":"https://api.croma.run/co/dnp/sisben-offices/v1","docs_url":"https://docs.usecroma.com/guides/colombia/dnp","country":"Colombia","source":"Departamento Nacional de Planeación (DNP)","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"The directory of Sisbén offices, from the DNP: every department's coordinator, or with `department_code` (two-digit DIVIPOLA) that department's coordinator and the administrator of each of its municipalities, with address, phone and email.","required":[],"request_schema":{"department_code":{"type":"string","enum":["","05","08","11","13","15","17","18","19","20","23","25","27","41","44","47","50","52","54","63","66","68","70","73","76","81","85","86","88","91","94","95","97","99"],"default":"","description":"Código DIVIPOLA de dos dígitos del departamento (p. ej. `05` Antioquia, `11` Bogotá). Vacío lista a los coordinadores de todos los departamentos."}},"example_request":{"department_code":"05"}},{"id":"terridata-indicators-search","name":"TerriData Indicators Search","method":"POST","path":"/co/terridata/indicators-search/v1","url":"https://api.croma.run/co/terridata/indicators-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/terridata","country":"Colombia","source":"DNP TerriData","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the catalog of Colombia's territorial statistics (DNP TerriData) by words in the indicator's name (Spanish) and by dimension (`14` poverty, `04` education, `05` health, `16` labour market, `07` public finance, ...). Returns each indicator's nine-digit code, unit, producing agency, how many territories report it and the years it spans. Use the code with the series and ranking endpoints. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional words to find in the indicator's name, in Spanish, e.g. `pobreza multidimensional`, `cobertura neta`, `homicidios`."},"dimension_code":{"type":"string","enum":["","11","12","13","14","15","16","19","20","22","25","26","27","28","29","30","31","01","02","03","04","05","06","07","08"],"default":"","description":"Optional two-digit dimension: `14` poverty, `04` education, `05` health, `16` labour market, `07` public finance, `12` economy, `06` safety, `03` housing and public services, `02` demographics. Empty searches every dimension."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"query":"pobreza multidimensional"}},{"id":"terridata-series","name":"TerriData Series by Territory","method":"POST","path":"/co/terridata/series/v1","url":"https://api.croma.run/co/terridata/series/v1","docs_url":"https://docs.usecroma.com/guides/colombia/terridata","country":"Colombia","source":"DNP TerriData","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Colombia's territorial statistics (DNP TerriData) for one territory, by its five-digit DANE code (`05001` Medellín, `05000` Antioquia, `01001` Colombia): every indicator's yearly values with unit and producing agency, optionally narrowed to one indicator code, one dimension or words in the indicator's name. `found: false` when the panel holds nothing for that territory. Served by Croma (`as_of` says how current the data is).","required":["territory_code"],"request_schema":{"territory_code":{"type":"string","pattern":"^\\d{5}$","description":"Five-digit DANE code of the territory: a municipality (`05001` Medellín, `11001` Bogotá), a department (its two digits plus `000`, e.g. `05000` Antioquia) or `01001` for Colombia as a whole."},"indicator_code":{"type":"string","pattern":"^(\\d{9})?$","default":"","description":"Optional nine-digit indicator code, as the indicator search returns it. Empty returns every indicator of the territory."},"dimension_code":{"type":"string","enum":["","11","12","13","14","15","16","19","20","22","25","26","27","28","29","30","31","01","02","03","04","05","06","07","08"],"default":"","description":"Optional two-digit dimension: `14` poverty, `04` education, `05` health, `16` labour market, `07` public finance, `12` economy, `06` safety, `03` housing and public services, `02` demographics. Empty searches every dimension."},"query":{"type":"string","maxLength":200,"default":"","description":"Optional words to find in the indicator's name, in Spanish, e.g. `pobreza multidimensional`, `cobertura neta`, `homicidios`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"territory_code":"05001","dimension_code":"14"}},{"id":"terridata-ranking","name":"TerriData Ranking","method":"POST","path":"/co/terridata/ranking/v1","url":"https://api.croma.run/co/terridata/ranking/v1","docs_url":"https://docs.usecroma.com/guides/colombia/terridata","country":"Colombia","source":"DNP TerriData","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Rank Colombia's municipalities (or departments) on one indicator of the DNP's territorial statistics (TerriData) for a year, or on each territory's latest value: highest or lowest first, optionally within one department. Returns rank, territory, year and value, plus the indicator's unit and producing agency. Served by Croma (`as_of` says how current the data is).","required":["indicator_code"],"request_schema":{"indicator_code":{"type":"string","pattern":"^\\d{9}$","description":"Nine-digit indicator code, as the indicator search returns it."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year to compare, e.g. `2024`. `0` compares each territory's latest value."},"level":{"type":"string","enum":["municipality","department"],"default":"municipality","description":"Optional level to compare: `municipality` (default) or `department`."},"department_code":{"type":"string","pattern":"^(\\d{2})?$","default":"","description":"Optional two-digit DANE code of a department, e.g. `05` for Antioquia: only its municipalities are compared."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","description":"Optional order: `desc` (highest value first, the default) or `asc`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"indicator_code":"140030015","per_page":10}},{"id":"supersociedades-shareholders","name":"Supersociedades Shareholders","method":"POST","path":"/co/supersociedades/shareholders/v1","url":"https://api.croma.run/co/supersociedades/shareholders/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades","country":"Colombia","source":"Supersociedades","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Shareholders or partners a Colombian company declared in the notes of its annual financial statements filed with the Superintendencia de Sociedades, by NIT: each holder's name, identity document, shares and percentage, plus the foreign investors, subsidiaries, associates and officers (legal representatives, accountant, revisor fiscal) declared in the same filing. Latest fiscal year by default, or a given year. Only companies that file with the Superintendencia (about 30,000 a year) are covered.","required":["document_number"],"request_schema":{"document_number":{"type":"string","minLength":4,"maxLength":15,"pattern":"^\\d{4,15}$","description":"Colombian NIT (numeric, no verification digit). 4-15 digits."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional fiscal year of the filing to read (2016 or later). 0 reads the latest filing."}},"example_request":{"document_number":"900249127"}},{"id":"supersociedades-financial-statements","name":"Supersociedades Financial Statements","method":"POST","path":"/co/supersociedades/financial-statements/v1","url":"https://api.croma.run/co/supersociedades/financial-statements/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades","country":"Colombia","source":"Supersociedades","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Annual financial statements a Colombian company has filed with the Superintendencia de Sociedades, by NIT: income statement, balance sheet and cash flow per fiscal year, plus the company identity from the filing cover. One filing per year (the preferred entry point, latest re-submission), newest first, up to 10 years. Figures come as filed, in the unit the filing declares.","required":["document_number"],"request_schema":{"document_number":{"type":"string","minLength":4,"maxLength":15,"pattern":"^\\d{4,15}$","description":"Colombian NIT (numeric, no verification digit). 4-15 digits."}},"example_request":{"document_number":"900249127"}},{"id":"supersociedades-companies-search","name":"Supersociedades Companies Search","method":"POST","path":"/co/supersociedades/companies-search/v1","url":"https://api.croma.run/co/supersociedades/companies-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades","country":"Colombia","source":"Supersociedades","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Every company that files annual financial statements with Colombia's Superintendencia de Sociedades (about 30,000 a year since fiscal 2015), searchable by name, fiscal year, macrosector (`construccion`, `comercio`, `manufactura`, ...), CIIU section, division or code, department, region, supervision status and minimum revenue. Each result is one filing: NIT, name, activity, location, supervision status, employees, and the headline figures (revenue, profit, assets, liabilities, equity, cash flows, ratios, ranking) in thousands of COP. Largest revenue first. One filing per company and year unless `include_all_filings` is true. Served by Croma (`as_of` says how current the data is); the latest year is searched when `fiscal_year` is 0.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional words matched against the company name (razón social) as filed."},"fiscal_year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional fiscal year (2015 or later). 0 searches the latest year available."},"macrosector":{"type":"string","enum":["any","agropecuario","minero","manufactura","construccion","comercio","servicios","transporte"],"default":"any","description":"Optional macrosector as the Superintendencia groups activities: `agropecuario`, `minero` (mining and hydrocarbons), `manufactura`, `construccion`, `comercio`, `servicios`, `transporte`, or `any`."},"ciiu_code":{"type":"string","pattern":"^(?:[A-Ua-u]|\\d{2,4})?$","default":"","description":"Optional CIIU Rev. 4 A.C. filter: a section letter (`F` for construction), a two-digit division (`42`), or a full four-digit code (`4220`)."},"department":{"type":"string","maxLength":80,"default":"","description":"Optional department of the company's domicile, e.g. `ANTIOQUIA`, `BOGOTA D.C.`. Case and accents are ignored."},"region":{"type":"string","enum":["any","bogota_cundinamarca","antioquia","costa_pacifica","region_caribe","centro_oriente","eje_cafetero","centro_sur","llanos"],"default":"any","description":"Optional region as the Superintendencia groups departments."},"supervision_status":{"type":"string","enum":["any","inspeccion","vigilancia","control","cancelada","exenta","nueva","camara_de_comercio"],"default":"any","description":"Optional standing before the Superintendencia: `inspeccion`, `vigilancia`, `control`, `cancelada`, `exenta`, `nueva` (roster only), `camara_de_comercio` (roster only), or `any`."},"min_revenue":{"type":"number","minimum":0,"default":0,"description":"Optional revenue floor for the fiscal year, in thousands of COP (`1000000` is one billion pesos). 0 applies no floor."},"include_all_filings":{"type":"boolean","default":false,"description":"`false` (default) returns one filing per company and fiscal year (the individual books when filed, else the separado, else the consolidado). `true` returns every filing, including consolidated ones."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"macrosector":"construccion","fiscal_year":2025,"per_page":20}},{"id":"supersociedades-company","name":"Supersociedades Company","method":"POST","path":"/co/supersociedades/company/v1","url":"https://api.croma.run/co/supersociedades/company/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades","country":"Colombia","source":"Supersociedades","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"A company's whole history of filings with the Superintendencia de Sociedades by NIT: every fiscal year since 2015, newest first, each with its activity, location, supervision status and headline figures (revenue, profit, assets, liabilities, equity, cash flows, ratios, ranking) in thousands of COP. The preferred filing of each year comes first. Served by Croma (`as_of` says how current the data is).","required":["document_number"],"request_schema":{"document_number":{"type":"string","minLength":4,"maxLength":15,"pattern":"^\\d{4,15}$","description":"Colombian NIT (numeric, no verification digit). 4-15 digits."}},"example_request":{"document_number":"900249127"}},{"id":"supersociedades-filing-statements","name":"Supersociedades Filing Statements","method":"POST","path":"/co/supersociedades/filing-statements/v1","url":"https://api.croma.run/co/supersociedades/filing-statements/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades","country":"Colombia","source":"Supersociedades","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"The full financial statements of one filing with the Superintendencia de Sociedades, by NIT and fiscal year (the latest by default): the filing cover (objeto social, corporate form, status, revisor fiscal and opinion, reporting unit), every line of the statement of financial position, the income statement, other comprehensive income and the cash flow statement with the previous year's restatement, the statement of changes in equity by component, the cash breakdown and the Superintendencia's financial indicators. Figures in thousands of COP. Served by Croma (`as_of` says how current the data is).","required":["document_number"],"request_schema":{"document_number":{"type":"string","minLength":4,"maxLength":15,"pattern":"^\\d{4,15}$","description":"Colombian NIT (numeric, no verification digit). 4-15 digits."},"fiscal_year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional fiscal year of the filing to read (2016 or later). 0 reads the latest filing."},"statement_type":{"type":"string","enum":["preferred","individual","separado","consolidado","combinado"],"default":"preferred","description":"Which filing of the year to read: `preferred` (the individual books when filed, else the separado, else the consolidado), or one of `individual`, `separado`, `consolidado`, `combinado`."}},"example_request":{"document_number":"900249127","fiscal_year":0}},{"id":"supersociedades-ownership-search","name":"Supersociedades Ownership Search","method":"POST","path":"/co/supersociedades/ownership-search/v1","url":"https://api.croma.run/co/supersociedades/ownership-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades","country":"Colombia","source":"Supersociedades","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Find the filings with the Superintendencia de Sociedades that declare a given person or company: by the identity document or NIT of a shareholder, an officer (legal representative, accountant, revisor fiscal) or a related company (subsidiary, associate, joint venture), optionally by role, company name and fiscal year. Each result is one filing's declared parties: shareholders with shares and percentage, foreign investors, subsidiaries, associates, joint ventures, officers and investor classes. Newest filing first. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"party_document_number":{"type":"string","pattern":"^(?:\\d{4,15})?$","default":"","description":"Optional identity document or NIT of a person or company, numeric, as declared in the notes: finds the filings that declare it as a shareholder, officer or related company."},"party_role":{"type":"string","enum":["any","shareholder","officer","related"],"default":"any","description":"Where to match `party_document_number`: among the `shareholder`s (and foreign investors), the `officer`s (legal representatives, accountant, revisor fiscal), the `related` companies (subsidiaries, associates, joint ventures), or `any`."},"query":{"type":"string","maxLength":200,"default":"","description":"Optional words matched against the company name (razón social) as filed."},"fiscal_year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional fiscal year (2015 or later). 0 searches every year."},"include_all_filings":{"type":"boolean","default":false,"description":"`false` (default) returns one filing per company and fiscal year (the individual books when filed, else the separado, else the consolidado). `true` returns every filing, including consolidated ones."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"party_document_number":"900249127","party_role":"any"}},{"id":"supersociedades-filing-ownership","name":"Supersociedades Filing Ownership","method":"POST","path":"/co/supersociedades/filing-ownership/v1","url":"https://api.croma.run/co/supersociedades/filing-ownership/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades","country":"Colombia","source":"Supersociedades","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"The parties one filing with the Superintendencia de Sociedades declares, by NIT and fiscal year (the latest by default): shareholders or partners with identity document, shares and percentage, foreign investors, subsidiaries, associates and joint ventures with their NIT, the legal representatives, accountant and revisor fiscal, and the classes of investor. Served by Croma (`as_of` says how current the data is).","required":["document_number"],"request_schema":{"document_number":{"type":"string","minLength":4,"maxLength":15,"pattern":"^\\d{4,15}$","description":"Colombian NIT (numeric, no verification digit). 4-15 digits."},"fiscal_year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional fiscal year of the filing to read (2016 or later). 0 reads the latest filing."},"statement_type":{"type":"string","enum":["preferred","individual","separado","consolidado","combinado"],"default":"preferred","description":"Which filing of the year to read: `preferred` (the individual books when filed, else the separado, else the consolidado), or one of `individual`, `separado`, `consolidado`, `combinado`."}},"example_request":{"document_number":"900249127","fiscal_year":0}},{"id":"supersociedades-filing-disclosures","name":"Supersociedades Filing Disclosures","method":"POST","path":"/co/supersociedades/filing-disclosures/v1","url":"https://api.croma.run/co/supersociedades/filing-disclosures/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades","country":"Colombia","source":"Supersociedades","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"The disclosure notes of one filing with the Superintendencia de Sociedades, by NIT and fiscal year (the latest by default), whole: property, plant and equipment, intangibles, leases, payables and receivables by age, revenue by activity, expenses, provisions, impairment, biological assets, investment property, the anti-money-laundering questionnaire of the Circular Básica Jurídica (five yes/no answers, also lifted as fields), and a parent's consolidated summary. Each note keeps every concept and member as filed. Served by Croma (`as_of` says how current the data is).","required":["document_number"],"request_schema":{"document_number":{"type":"string","minLength":4,"maxLength":15,"pattern":"^\\d{4,15}$","description":"Colombian NIT (numeric, no verification digit). 4-15 digits."},"fiscal_year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional fiscal year of the filing to read (2016 or later). 0 reads the latest filing."},"statement_type":{"type":"string","enum":["preferred","individual","separado","consolidado","combinado"],"default":"preferred","description":"Which filing of the year to read: `preferred` (the individual books when filed, else the separado, else the consolidado), or one of `individual`, `separado`, `consolidado`, `combinado`."}},"example_request":{"document_number":"900249127","fiscal_year":0}},{"id":"supersociedades-insolvency-processes-search","name":"Supersociedades Insolvency Processes Search","method":"POST","path":"/co/supersociedades/insolvency-processes-search/v1","url":"https://api.croma.run/co/supersociedades/insolvency-processes-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades","country":"Colombia","source":"Supersociedades","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Every insolvency process a company reports in its annual filings with the Superintendencia de Sociedades (reorganización, liquidación judicial, acuerdos de reestructuración, concordatos, liquidación obligatoria, validación judicial), searchable by NIT, company name, process type, whether still open and admission date range. Each result is one process as the latest filing reports it: type, stage, origin, admission and closing dates. Most recently admitted first. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"document_number":{"type":"string","pattern":"^(?:\\d{4,15})?$","default":"","description":"Optional Colombian NIT (numeric, no verification digit) to restrict the search to one company."},"query":{"type":"string","maxLength":200,"default":"","description":"Optional words matched against the company name (razón social) as filed."},"process_type":{"type":"string","enum":["any","reorganizacion","liquidacion_judicial","acuerdos_de_reestructuracion","concordatos","liquidacion_obligatoria","validacion"],"default":"any","description":"Optional process type: `reorganizacion`, `liquidacion_judicial`, `acuerdos_de_reestructuracion` (Ley 550), `concordatos`, `liquidacion_obligatoria`, `validacion` (validación judicial de acuerdos), or `any`."},"active_only":{"type":"boolean","default":false,"description":"`true` returns only processes with no closing date reported."},"admitted_from":{"type":"string","pattern":"^(?:\\d{4}-\\d{2}-\\d{2})?$","default":"","description":"Optional earliest admission date, `yyyy-mm-dd`, inclusive."},"admitted_to":{"type":"string","pattern":"^(?:\\d{4}-\\d{2}-\\d{2})?$","default":"","description":"Optional latest admission date, `yyyy-mm-dd`, inclusive."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"process_type":"reorganizacion","active_only":true,"per_page":20}},{"id":"supersociedades-largest-companies-search","name":"Supersociedades Largest Companies Search","method":"POST","path":"/co/supersociedades/largest-companies-search/v1","url":"https://api.croma.run/co/supersociedades/largest-companies-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades","country":"Colombia","source":"Supersociedades","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"The 10,000 largest companies in Colombia each fiscal year since 2021, as the Superintendencia de Sociedades publishes them, whichever superintendencia supervises them (Supersociedades, Superfinanciera, Supersalud, Superservicios, Supertransporte, Supervigilancia): searchable by name, year, macrosector, supervisor, CIIU and department. Each result is one company in one year: NIT, name, supervisor, region, department, city, CIIU, macrosector, rank, and revenue, profit, assets, liabilities and equity in billions of COP. By rank. Served by Croma (`as_of` says how current the data is); the latest year is searched when `fiscal_year` is 0.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional words matched against the company name (razón social) as filed."},"fiscal_year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional fiscal year (2015 or later). 0 searches the latest year available."},"macrosector":{"type":"string","enum":["any","agropecuario","minero","manufactura","construccion","comercio","servicios","transporte"],"default":"any","description":"Optional macrosector as the Superintendencia groups activities: `agropecuario`, `minero` (mining and hydrocarbons), `manufactura`, `construccion`, `comercio`, `servicios`, `transporte`, or `any`."},"supervisor":{"type":"string","enum":["any","supersociedades","superfinanciera","supersalud","superservicios","supertransporte","supervigilancia"],"default":"any","description":"Optional supervisor of the company: `supersociedades`, `superfinanciera`, `supersalud`, `superservicios`, `supertransporte`, `supervigilancia`, or `any`."},"ciiu_code":{"type":"string","pattern":"^(?:[A-Ua-u]|\\d{2,4})?$","default":"","description":"Optional CIIU Rev. 4 A.C. filter: a section letter (`F` for construction), a two-digit division (`42`), or a full four-digit code (`4220`)."},"department":{"type":"string","maxLength":80,"default":"","description":"Optional department of the company's domicile, e.g. `ANTIOQUIA`, `BOGOTA D.C.`. Case and accents are ignored."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"fiscal_year":2025,"macrosector":"construccion","per_page":20}},{"id":"supersociedades-supervised-entities-search","name":"Supersociedades Supervised Entities Search","method":"POST","path":"/co/supersociedades/supervised-entities-search/v1","url":"https://api.croma.run/co/supersociedades/supervised-entities-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades","country":"Colombia","source":"Supersociedades","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"The roster of entities under the supervision of Colombia's Superintendencia de Sociedades at each year-end since 2021 (about 32,000 a year), searchable by name, NIT, standing (inspección, vigilancia, control, nueva) and department. Each result is one entity at one corte: NIT and check digit, name, standing, and the judicial notification address, department, city and email. Served by Croma (`as_of` says how current the data is); the latest corte is searched when `fiscal_year` is 0.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional words matched against the company name (razón social) as filed."},"document_number":{"type":"string","pattern":"^(?:\\d{4,15})?$","default":"","description":"Optional Colombian NIT (numeric, no verification digit) to restrict the search to one company."},"supervision_status":{"type":"string","enum":["any","inspeccion","vigilancia","control","cancelada","exenta","nueva","camara_de_comercio"],"default":"any","description":"Optional standing before the Superintendencia: `inspeccion`, `vigilancia`, `control`, `cancelada`, `exenta`, `nueva` (roster only), `camara_de_comercio` (roster only), or `any`."},"department":{"type":"string","maxLength":80,"default":"","description":"Optional department of the company's domicile, e.g. `ANTIOQUIA`, `BOGOTA D.C.`. Case and accents are ignored."},"fiscal_year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional fiscal year (2015 or later). 0 searches the latest year available."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"supervision_status":"vigilancia","department":"ANTIOQUIA","per_page":20}},{"id":"supersociedades-baranda-publications-search","name":"Supersociedades Baranda Publications Search","method":"POST","path":"/co/supersociedades-baranda/publications-search/v1","url":"https://api.croma.run/co/supersociedades-baranda/publications-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades-baranda","country":"Colombia","source":"Supersociedades Baranda Virtual","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Everything the Superintendencia de Sociedades has published on its Baranda Virtual since 2024 (estados, traslados, avisos, sentencias, autos, edictos and publicidad of every delegatura and intendencia regional), searchable by the NIT or cédula of the company or person it is about, by words of its name, subject or trámite, by list, dependencia, radicado, expediente and date. Each result carries the trámite, the dates, the company, the source's viewer link and our copy of the radicado's files. An estado row is the list itself; to search what the notified autos say, use `supersociedades_baranda_decisions_search`. Served by Croma from its copy (`as_of` says how current it is).","required":[],"request_schema":{"document_number":{"type":"string","maxLength":15,"default":"","description":"Optional NIT or cédula of the company or person the publication is about, digits only."},"query":{"type":"string","maxLength":200,"default":"","description":"Optional words matched against the company or person name, the subject and the trámite of the publication."},"kind":{"type":"string","enum":["any","estado","traslado","aviso","sentencia","auto","edicto","publicidad"],"default":"any","description":"Optional list to search: `estado`, `traslado`, `aviso`, `sentencia`, `auto`, `edicto`, `publicidad`, or `any`."},"dependency":{"type":"string","maxLength":60,"default":"","description":"Optional dependencia code as the source keys its lists, e.g. `apoyoJudicialR` (reorganización y concordato), `apoyoJudicialL` (liquidaciones), `apoyoJudicialPM` (procedimientos mercantiles), `notificaciones`, `medellinNew`. Every publication carries its `dependency`."},"filing_id":{"type":"string","maxLength":14,"default":"","description":"Optional número de radicado, `yyyy-01-nnnnnn`."},"file_number":{"type":"string","maxLength":40,"default":"","description":"Optional expediente (process file) number as the source prints it."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Rows per page, 1-100."}},"example_request":{"kind":"aviso","from_date":"2026-08-01","per_page":20}},{"id":"supersociedades-baranda-publication","name":"Supersociedades Baranda Publication","method":"POST","path":"/co/supersociedades-baranda/publication/v1","url":"https://api.croma.run/co/supersociedades-baranda/publication/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades-baranda","country":"Colombia","source":"Supersociedades Baranda Virtual","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"One radicado as the Superintendencia de Sociedades published it on its Baranda Virtual: every list it appeared under (estado, traslado, aviso, ...), with the trámite, the dates, the company or person it is about, the source's viewer link and our copy of its files. Served by Croma from its copy of the publications since 2024.","required":["filing_id"],"request_schema":{"filing_id":{"type":"string","minLength":14,"maxLength":14,"pattern":"^\\d{4}-\\d{2}-\\d{6}$","description":"Número de radicado as the Superintendencia prints it, `yyyy-01-nnnnnn`."}},"example_request":{"filing_id":"2026-01-706561"}},{"id":"supersociedades-baranda-decisions-search","name":"Supersociedades Decisions Search","method":"POST","path":"/co/supersociedades-baranda/decisions-search/v1","url":"https://api.croma.run/co/supersociedades-baranda/decisions-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades-baranda","country":"Colombia","source":"Supersociedades Baranda Virtual","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the full text of the autos (court orders) the Superintendencia de Sociedades notifies in its daily estados since 2024: procedimientos mercantiles (corporate and commercial disputes, where it acts as a court), reorganización, liquidación judicial, intervención and its six intendencias regionales. Use it to find how the Superintendencia has recently ruled on a legal issue (write `query` in Spanish legal wording, e.g. `levantamiento de medidas cautelares poseedor`, `nulidad por indebida notificación`, `desestimación de la personalidad jurídica`), to follow every decision in a company's insolvency by NIT, or to read a day's estados without opening PDFs (`from_date` = `to_date`). Each result is one auto, newest notified first: the company or parties, the process, the asunto, the expediente and case number, the court officer, the dates, the estado line that notified it, the opening of what it orders, and our copy of the PDF. Results carry no full text: call `supersociedades_baranda_decision` with a result's `filing_id` to read the reasoning. Served by Croma from its copy (`as_of` says how current it is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional words matched against the full text of each auto (the antecedentes, the Superintendencia's reasoning and what it orders), the company or parties, the asunto and the estado line, in Spanish, e.g. `levantamiento medidas cautelares poseedor` or `nulidad por indebida notificación`. Results stay newest first."},"document_number":{"type":"string","maxLength":15,"default":"","description":"Optional NIT or cédula of the company or person the process is about, digits only, no verification digit. Autos of procedimientos mercantiles name parties instead; search those with `query`."},"dependency":{"type":"string","enum":["any","apoyoJudicialPM","apoyoJudicialR","apoyoJudicialL","apoyoJudicialI","barranquillaNew","bucaramangaNew","caliNew","cartagenaNew","manizalesNew","medellinNew"],"default":"any","description":"Optional dependencia that notified the auto: `apoyoJudicialPM` (procedimientos mercantiles: corporate disputes, shareholder actions, piercing the corporate veil, the Superintendencia acting as a commercial court), `apoyoJudicialR` (reorganización), `apoyoJudicialL` (liquidación judicial), `apoyoJudicialI` (intervención), an intendencia regional (`barranquillaNew`, `bucaramangaNew`, `caliNew`, `cartagenaNew`, `manizalesNew`, `medellinNew`), or `any`."},"case_number":{"type":"string","maxLength":40,"default":"","description":"Optional número de proceso exactly as the auto prints it, e.g. `2024-800-00267` (procedimientos mercantiles) or `2024-INS-3404`."},"file_number":{"type":"string","maxLength":40,"default":"","description":"Optional expediente (process file) number as the source prints it."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Rows per page, 1-100."}},"example_request":{"query":"medidas cautelares","dependency":"apoyoJudicialL","from_date":"2026-09-01","per_page":10}},{"id":"supersociedades-baranda-decision","name":"Supersociedades Decision","method":"POST","path":"/co/supersociedades-baranda/decision/v1","url":"https://api.croma.run/co/supersociedades-baranda/decision/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades-baranda","country":"Colombia","source":"Supersociedades Baranda Virtual","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"One auto (court order) of the Superintendencia de Sociedades by its radicado, with its full text: the antecedentes, the Superintendencia's reasoning with the norms and precedents it cites, and what it orders, plus the company or parties, the process, the expediente, the court officer, the dates, the estado that notified it and our copy of the PDF. Use it after `supersociedades_baranda_decisions_search` to read a decision worth citing, or with a radicado taken from an estado. Served by Croma from its copy of the autos notified since 2024.","required":["filing_id"],"request_schema":{"filing_id":{"type":"string","minLength":14,"maxLength":14,"pattern":"^\\d{4}-\\d{2}-\\d{6}$","description":"Número de radicado as the Superintendencia prints it, `yyyy-01-nnnnnn`."}},"example_request":{"filing_id":"2026-01-732052"}},{"id":"supersociedades-baranda-company-file","name":"Supersociedades Company File","method":"POST","path":"/co/supersociedades-baranda/company-file/v1","url":"https://api.croma.run/co/supersociedades-baranda/company-file/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades-baranda","country":"Colombia","source":"Supersociedades Baranda Virtual","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"A company's or person's file at the Superintendencia de Sociedades, read live from its Baranda Virtual by NIT or cédula: its standing (inspección, vigilancia, control), situation (activa, reorganización, liquidación, ...), stage, cause, activity and domicile; its legal representatives, auditors and accountants; and, ten per page, the decisions (providencias) the Superintendencia issued in its processes and what was filed into them (entradas), newest first, each with the source's viewer link. Asynchronous: the source needs a verification per session.","required":["document_number"],"request_schema":{"document_number":{"type":"string","minLength":4,"maxLength":15,"pattern":"^\\d{4,15}$","description":"NIT or cédula of the company or person, digits only, no verification digit. 4-15 digits."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"document_number":"900553004"}},{"id":"supersociedades-baranda-company-search","name":"Supersociedades Company Search","method":"POST","path":"/co/supersociedades-baranda/company-search/v1","url":"https://api.croma.run/co/supersociedades-baranda/company-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades-baranda","country":"Colombia","source":"Supersociedades Baranda Virtual","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Companies and persons the Superintendencia de Sociedades holds a file on, by words of their name or sigla, read live from its Baranda Virtual: NIT, name, type, supervision standing, situation, stage, activity and domicile of each match. Asynchronous: the source needs a verification per session.","required":["query"],"request_schema":{"query":{"type":"string","minLength":3,"maxLength":120,"description":"Words of the company's name (razón social) or sigla, at least 3 characters."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Rows per page, 1-100."}},"example_request":{"query":"TERRA BUNKERING"}},{"id":"supersociedades-baranda-filing","name":"Supersociedades Filing by Radicado","method":"POST","path":"/co/supersociedades-baranda/filing/v1","url":"https://api.croma.run/co/supersociedades-baranda/filing/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades-baranda","country":"Colombia","source":"Supersociedades Baranda Virtual","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"One radicado of the Superintendencia de Sociedades read live from its Baranda Virtual: the trámite, the process, the dates, the company or person it is about, the source's viewer link, and the other radicados of the same expediente. Asynchronous: the source needs a verification per session.","required":["filing_id"],"request_schema":{"filing_id":{"type":"string","minLength":14,"maxLength":14,"pattern":"^\\d{4}-\\d{2}-\\d{6}$","description":"Número de radicado as the Superintendencia prints it, `yyyy-01-nnnnnn`."}},"example_request":{"filing_id":"2026-01-706561"}},{"id":"supersociedades-relatoria-documents-search","name":"Supersociedades Relatoría Search","method":"POST","path":"/co/supersociedades-relatoria/documents-search/v1","url":"https://api.croma.run/co/supersociedades-relatoria/documents-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades-relatoria","country":"Colombia","source":"Supersociedades Relatoría","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"The Superintendencia de Sociedades' conceptos jurídicos (since 1993) and the sentencias of its Delegatura de Procedimientos Mercantiles, searchable by words over the title, subject and full text, by kind, thesaurus descriptor, subject, party NIT or cédula, radicado, case number, year and date. Each result carries the descriptors, the parties and the dates; the `document` endpoint returns the full text, the legal sources, the problemas jurídicos and the sentencia's parts. Served by Croma from its copy (`as_of` says how current it is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional words matched against the title, the subject and the full text."},"content_type":{"type":"string","enum":["any","legal_opinion","ruling","oral_ruling","topic"],"default":"any","description":"Optional kind of document: `legal_opinion` (concepto jurídico), `ruling` (sentencia escrita), `oral_ruling` (sentencia en audiencia), `topic` (tema y problema), or `any`."},"descriptor":{"type":"string","maxLength":120,"default":"","description":"Optional main descriptor of the relatoría's thesaurus, exactly as it prints it, e.g. `Administradores`."},"subject":{"type":"string","maxLength":200,"default":"","description":"Optional tema exactly as the relatoría names it, e.g. `Responsabilidad de los administradores`."},"party_document_number":{"type":"string","maxLength":15,"default":"","description":"Optional NIT or cédula of the company or person the publication is about, digits only."},"consecutive":{"type":"string","maxLength":10,"default":"","description":"Optional consecutivo of the concepto or sentencia, `nnn-nnnnnn`, e.g. `220-001087`."},"filing_id":{"type":"string","maxLength":14,"default":"","description":"Optional número de radicado, `yyyy-01-nnnnnn`."},"case_number":{"type":"string","maxLength":30,"default":"","description":"Optional número de proceso as the Superintendencia prints it, e.g. `2019-800-00212`."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year (1990 or later). 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Rows per page, 1-100."}},"example_request":{"query":"abuso del derecho de voto","content_type":"ruling","per_page":20}},{"id":"supersociedades-relatoria-document","name":"Supersociedades Relatoría Document","method":"POST","path":"/co/supersociedades-relatoria/document/v1","url":"https://api.croma.run/co/supersociedades-relatoria/document/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades-relatoria","country":"Colombia","source":"Supersociedades Relatoría","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"One concepto jurídico or sentencia of the Superintendencia de Sociedades by its identifier, whole: the full text as the relatoría transcribed it, the legal sources and citations, the parties, the problemas jurídicos with the doctrinal positions on them, and the sentencia split in its parts (facts, claims, considerations, resolution). Served by Croma from its copy.","required":["id"],"request_schema":{"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$","description":"The document's identifier, as a search result carries it in `id`."}},"example_request":{"id":"49850"}},{"id":"supersociedades-relatoria-historical-rulings-search","name":"Supersociedades Historical Rulings Search","method":"POST","path":"/co/supersociedades-relatoria/historical-rulings-search/v1","url":"https://api.croma.run/co/supersociedades-relatoria/historical-rulings-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades-relatoria","country":"Colombia","source":"Supersociedades Relatoría","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"The ruling files the Superintendencia de Sociedades keeps on its portal, one PDF each: about 18,000 autos and sentencias of the insolvency delegatura (2012-2021) and about 330 of the mercantile delegatura (2012-2019), searchable by words over the title, description, case and subject, by collection, category, year and date, each with the Superintendencia's metadata and our copy of the file. Served by Croma from its copy.","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional words matched against the title, the subject and the full text."},"collection":{"type":"string","enum":["any","insolvency","mercantile"],"default":"any","description":"Optional collection: `insolvency` (rulings of the insolvency delegatura), `mercantile` (rulings of the mercantile delegatura), or `any`."},"category":{"type":"string","maxLength":120,"default":"","description":"Optional category as the Superintendencia names it, e.g. `Liquidaciones`, `Reorganización`, `Régimen de Administradores`."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year (1990 or later). 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Rows per page, 1-100."}},"example_request":{"collection":"mercantile","query":"administradores","per_page":20}},{"id":"supersociedades-relatoria-opinion-files-search","name":"Supersociedades Opinion Files Search","method":"POST","path":"/co/supersociedades-relatoria/opinion-files-search/v1","url":"https://api.croma.run/co/supersociedades-relatoria/opinion-files-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades-relatoria","country":"Colombia","source":"Supersociedades Relatoría","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"The conceptos of the Superintendencia de Sociedades as its portal publishes them, one PDF each: about 13,000 conceptos jurídicos of its legal office and about 900 conceptos contables since 2013, searchable by words over the title and epígrafe, by collection, consecutivo, year, whether the Superintendencia marks them as vigente, and date, each with our copy of the file. The consecutivo joins a concepto jurídico to its full text in `documents-search`. Served by Croma from its copy.","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional words matched against the title, the subject and the full text."},"collection":{"type":"string","enum":["any","legal","accounting"],"default":"any","description":"Optional collection: `legal` (conceptos jurídicos), `accounting` (conceptos contables), or `any`."},"consecutive":{"type":"string","maxLength":10,"default":"","description":"Optional consecutivo of the concepto or sentencia, `nnn-nnnnnn`, e.g. `220-001087`."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year (1990 or later). 0 searches every year."},"in_force":{"type":"string","enum":["any","yes","no"],"default":"any","description":"Optional: `yes` for conceptos the Superintendencia marks as vigente, `no` for the ones it marks as no longer in force, or `any`."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Rows per page, 1-100."}},"example_request":{"collection":"legal","query":"oficial de cumplimiento","per_page":20}},{"id":"supersociedades-relatoria-bulletins-search","name":"Supersociedades Bulletins Search","method":"POST","path":"/co/supersociedades-relatoria/bulletins-search/v1","url":"https://api.croma.run/co/supersociedades-relatoria/bulletins-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades-relatoria","country":"Colombia","source":"Supersociedades Relatoría","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"The bulletins of the Superintendencia de Sociedades: the monthly Boletín de Conceptos Jurídicos since 2010 and the Boletín de Conceptos Contables by semester of its legal office, plus the mercantile delegatura's compilations (the six volumes of its Boletín de Jurisprudencia and the four Libros de Jurisprudencia Societaria), searchable by words over the title and summary, by series and date, each with our copy of the PDF where the Superintendencia hosts it. Served by Croma from its copy.","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional words matched against the title, the subject and the full text."},"series":{"type":"string","enum":["any","legal_opinions","accounting","jurisprudence"],"default":"any","description":"Optional series: `legal_opinions` (Boletín de Conceptos Jurídicos), `accounting` (Boletín de Conceptos Contables), `jurisprudence` (Boletín de Jurisprudencia and Libros de Jurisprudencia Societaria of the mercantile delegatura), or `any`."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Rows per page, 1-100."}},"example_request":{"series":"legal_opinions","from_date":"2026-01-01"}},{"id":"supersociedades-relatoria-notices-search","name":"Supersociedades Notices Search","method":"POST","path":"/co/supersociedades-relatoria/notices-search/v1","url":"https://api.croma.run/co/supersociedades-relatoria/notices-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades-relatoria","country":"Colombia","source":"Supersociedades Relatoría","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"The notices the Superintendencia de Sociedades publishes on its portal since 2006: avisos of agentes interventores, reorganizations, judicial and mandatory liquidations, liquidations by adjudication, special proceedings and general insolvency matters, each with its text and our copy of its files; and the autos of civil courts on insolvency processes, which the Superintendencia lists for about a week and this copy keeps. Searchable by words over the title and text, by kind and date. Served by Croma from its copy.","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional words matched against the title, the subject and the full text."},"kind":{"type":"string","enum":["any","intervention","reorganization","judicial_liquidation","mandatory_liquidation","adjudication","special","general","court_order"],"default":"any","description":"Optional kind of notice: `intervention`, `reorganization`, `judicial_liquidation`, `mandatory_liquidation`, `adjudication`, `special`, `general`, `court_order`, or `any`."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Rows per page, 1-100."}},"example_request":{"kind":"intervention","from_date":"2026-01-01","per_page":20}},{"id":"supersociedades-relatoria-notice","name":"Supersociedades Notice","method":"POST","path":"/co/supersociedades-relatoria/notice/v1","url":"https://api.croma.run/co/supersociedades-relatoria/notice/v1","docs_url":"https://docs.usecroma.com/guides/colombia/supersociedades-relatoria","country":"Colombia","source":"Supersociedades Relatoría","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"One notice of the Superintendencia de Sociedades' portal by its identifier, with its text and our copy of its files. Served by Croma from its copy.","required":["id"],"request_schema":{"id":{"type":"string","minLength":7,"maxLength":30,"pattern":"^(notice|order):\\d+$","description":"The notice's identifier, as a search result carries it in `id`: `notice:<n>` or `order:<n>`."}},"example_request":{"id":"notice:10086353"}},{"id":"dof-publications-by-date","name":"DOF Publications by Date","method":"POST","path":"/mx/dof/publications-by-date/v1","url":"https://api.croma.run/mx/dof/publications-by-date/v1","docs_url":"https://docs.usecroma.com/guides/mexico/dof","country":"Mexico","source":"DOF","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Everything published in Mexico's official federal gazette (Diario Oficial de la Federación) on a given date: decrees, law reforms, and regulator disposiciones across the morning, evening, and extraordinary editions, each with its issuing branch and agency. The gazette is organised by day, so a date is the only way in; it publishes the decree that created or amended a law, never the consolidated current text of one. For that, use `diputados-federal-law`. The index reaches back to 1917, while machine-readable text starts with the 1973 volume: `has_text: true` marks publications retrievable with `dof-publication`, and every entry carries `scan_url` for the official scanned page.","required":["date"],"request_schema":{"date":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Gazette date (yyyy-mm-dd). The index reaches back to 1917; machine-readable text starts with the 1973 volume, and earlier publications are served as scans."}},"example_request":{"date":"2026-07-16"}},{"id":"dof-publication","name":"DOF Publication","method":"POST","path":"/mx/dof/publication/v1","url":"https://api.croma.run/mx/dof/publication/v1","docs_url":"https://docs.usecroma.com/guides/mexico/dof","country":"Mexico","source":"DOF","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Retrieve one publication from Mexico's official federal gazette (DOF) by id, including its plain text when the publication is machine-readable. Publications range from a few hundred characters to entire decrees, so the text is returned in character ranges: `content.total_length` is the full size, and when `content.has_more` is true request the next range with `offset: content.next_offset`. Anything published before the 1973 volume is held only as a scan and returns `is_image_only: true` with `content: null`, its metadata, and `scan_url` for the official scanned page. This returns one gazette publication, not the consolidated text of a law; for that use `diputados-federal-law`.","required":["publication_id"],"request_schema":{"publication_id":{"type":"string","pattern":"^\\d{1,12}$","description":"Publication id (`id` from publications-by-date or search results)."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"publication_id":"5778302"}},{"id":"fiscalia-cdmx-bulletins","name":"Fiscalía CDMX Bulletins","method":"POST","path":"/mx/fiscalias/cdmx/bulletins/v1","url":"https://api.croma.run/mx/fiscalias/cdmx/bulletins/v1","docs_url":"https://docs.usecroma.com/guides/mexico/fiscalias","country":"Mexico","source":"Fiscalía General de Justicia de la Ciudad de México","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Browse the public press bulletins (comunicados) of the Mexico City prosecutor, most recent first, paged with `page` (10 per page). Each bulletin carries its comunicado `code`, date, headline, and summary. These are public press releases, not a criminal-record database: a name in a bulletin is an indicio, never proof, and procedural stage must not be read as a conviction.","required":[],"request_schema":{"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"page":1}},{"id":"fiscalia-chiapas-bulletins","name":"Fiscalía Chiapas Bulletins","method":"POST","path":"/mx/fiscalias/chiapas/bulletins/v1","url":"https://api.croma.run/mx/fiscalias/chiapas/bulletins/v1","docs_url":"https://docs.usecroma.com/guides/mexico/fiscalias","country":"Mexico","source":"Fiscalía General del Estado de Chiapas","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Browse the public press bulletins (comunicados) of the Chiapas state prosecutor, most recent first; page forward with `page` until `has_more` is false. Each bulletin carries its comunicado number, classification, date, headline, and summary. These are public press releases, not a criminal-record database: a name in a bulletin is an indicio, never proof, and procedural stage must not be read as a conviction.","required":[],"request_schema":{"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"page":1}},{"id":"fiscalia-chihuahua-bulletins","name":"Fiscalía Chihuahua Bulletins","method":"POST","path":"/mx/fiscalias/chihuahua/bulletins/v1","url":"https://api.croma.run/mx/fiscalias/chihuahua/bulletins/v1","docs_url":"https://docs.usecroma.com/guides/mexico/fiscalias","country":"Mexico","source":"Fiscalía General del Estado de Chihuahua","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search the public press bulletins (comunicados) of the Chihuahua state prosecutor. Free-text `query` searches the corpus; omit it for the most recent. Optional `from_date`/`to_date` bound the range. Each bulletin announces one procedural event (arrest, imputation, conviction, sentence); the `categories` name the acting unit. These are public press releases, not a criminal-record database: a name in a bulletin is an indicio, never proof, and procedural stage must not be read as a conviction.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Free-text search over the bulletins. Omit for the most recent."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date bound (yyyy-mm-dd). Omit for no bound."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date bound (yyyy-mm-dd). Omit for no bound."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"query":"homicidio"}},{"id":"fiscalia-edomex-bulletins","name":"Fiscalía Estado de México Bulletins","method":"POST","path":"/mx/fiscalias/edomex/bulletins/v1","url":"https://api.croma.run/mx/fiscalias/edomex/bulletins/v1","docs_url":"https://docs.usecroma.com/guides/mexico/fiscalias","country":"Mexico","source":"Fiscalía General de Justicia del Estado de México","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Browse the public press bulletins (comunicados) of the Estado de México prosecutor, most recent first; page forward with `page` until `has_more` is false. Each bulletin carries its comunicado `code`, date, headline, and a link to the full document. These are public press releases, not a criminal-record database: a name in a bulletin is an indicio, never proof, and procedural stage must not be read as a conviction.","required":[],"request_schema":{"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"page":1}},{"id":"fiscalia-fgr-bulletins","name":"FGR Bulletins","method":"POST","path":"/mx/fiscalias/fgr/bulletins/v1","url":"https://api.croma.run/mx/fiscalias/fgr/bulletins/v1","docs_url":"https://docs.usecroma.com/guides/mexico/fiscalias","country":"Mexico","source":"Fiscalía General de la República","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Browse the public press bulletins (comunicados) of the federal prosecutor (FGR), most recent first; page forward with `page` until `has_more` is false. Each item carries its bulletin `code`, `scope` (national or state), date, and headline, and links to the full comunicado. These are public press releases, not a criminal-record database: a name in a bulletin is an indicio, never proof, and procedural stage must not be read as a conviction.","required":[],"request_schema":{"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"page":1}},{"id":"fiscalia-jalisco-bulletins","name":"Fiscalía Jalisco Bulletins","method":"POST","path":"/mx/fiscalias/jalisco/bulletins/v1","url":"https://api.croma.run/mx/fiscalias/jalisco/bulletins/v1","docs_url":"https://docs.usecroma.com/guides/mexico/fiscalias","country":"Mexico","source":"Fiscalía del Estado de Jalisco","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search the public press bulletins (comunicados) of the Jalisco state prosecutor. Free-text `query` searches the corpus; omit it for the most recent. Each bulletin announces one procedural event (arrest, imputation, conviction, sentence) and carries the issuing author and tags. These are public press releases, not a criminal-record database: a name in a bulletin is an indicio, never proof, and procedural stage must not be read as a conviction.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Free-text search over the bulletins. Omit for the most recent."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"query":"vinculado a proceso"}},{"id":"fiscalia-nuevoleon-bulletins","name":"Fiscalía Nuevo León Bulletins","method":"POST","path":"/mx/fiscalias/nuevoleon/bulletins/v1","url":"https://api.croma.run/mx/fiscalias/nuevoleon/bulletins/v1","docs_url":"https://docs.usecroma.com/guides/mexico/fiscalias","country":"Mexico","source":"Fiscalía General de Justicia del Estado de Nuevo León","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search the public press bulletins (comunicados) of the Nuevo León prosecutor. Free-text `query` searches the corpus; omit it for the most recent. Each bulletin carries its date, headline, and summary. These are public press releases, not a criminal-record database: a name in a bulletin is an indicio, never proof, and procedural stage must not be read as a conviction.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Free-text search over the bulletins. Omit for the most recent."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"query":"homicidio"}},{"id":"fiscalia-puebla-bulletins","name":"Fiscalía Puebla Bulletins","method":"POST","path":"/mx/fiscalias/puebla/bulletins/v1","url":"https://api.croma.run/mx/fiscalias/puebla/bulletins/v1","docs_url":"https://docs.usecroma.com/guides/mexico/fiscalias","country":"Mexico","source":"Fiscalía General del Estado de Puebla","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search the public press bulletins (comunicados) of the Puebla state prosecutor. Free-text `query` searches the corpus; omit it for the most recent. Each bulletin carries its numbered boletín, date, and headline. These are public press releases, not a criminal-record database: a name in a bulletin is an indicio, never proof, and procedural stage must not be read as a conviction.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Free-text search over the bulletins. Omit for the most recent."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"query":"homicidio"}},{"id":"fiscalia-veracruz-bulletins","name":"Fiscalía Veracruz Bulletins","method":"POST","path":"/mx/fiscalias/veracruz/bulletins/v1","url":"https://api.croma.run/mx/fiscalias/veracruz/bulletins/v1","docs_url":"https://docs.usecroma.com/guides/mexico/fiscalias","country":"Mexico","source":"Fiscalía General del Estado de Veracruz","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search the public press bulletins (comunicados) of the Veracruz state prosecutor. Free-text `query` searches the corpus; omit it for the most recent. Optional `from_date`/`to_date` bound the range. Each bulletin announces one procedural event (arrest, imputation, conviction, sentence). These are public press releases, not a criminal-record database: a name in a bulletin is an indicio, never proof, and procedural stage must not be read as a conviction.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Free-text search over the bulletins. Omit for the most recent."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date bound (yyyy-mm-dd). Omit for no bound."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date bound (yyyy-mm-dd). Omit for no bound."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"query":"detenido"}},{"id":"fiscalia-zacatecas-bulletins","name":"Fiscalía Zacatecas Bulletins","method":"POST","path":"/mx/fiscalias/zacatecas/bulletins/v1","url":"https://api.croma.run/mx/fiscalias/zacatecas/bulletins/v1","docs_url":"https://docs.usecroma.com/guides/mexico/fiscalias","country":"Mexico","source":"Fiscalía General de Justicia del Estado de Zacatecas","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Browse the public press bulletins (comunicados) of the Zacatecas state prosecutor, most recent first; page forward with `page` until `has_more` is false. Each bulletin announces one procedural event (arrest, imputation, conviction, sentence) and carries the full text. These are public press releases, not a criminal-record database: a name in a bulletin is an indicio, never proof, and procedural stage must not be read as a conviction.","required":[],"request_schema":{"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"page":1}},{"id":"scjn-tesis-search","name":"SCJN Tesis Search","method":"POST","path":"/mx/scjn/tesis-search/v1","url":"https://api.croma.run/mx/scjn/tesis-search/v1","docs_url":"https://docs.usecroma.com/guides/mexico/scjn","country":"Mexico","source":"SCJN","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the Mexican Supreme Court's case law: every tesis and jurisprudencia the Semanario Judicial de la Federación has published since 1911 (300k+), each in full. Match words in the title and text (`query`, optional; every word must appear) and filter by binding force (`tesis_type`: jurisprudencia vs aislada), subject (materia), época number, year, deciding level (`instance`), court or chamber, how the criterion was formed (`formation`), publication window (`published_from`/`published_to`) and the court's own modification date (`updated_after`). Newest first, pages of up to 50 full records; `as_of` says how current the data is. Read one by its registro digital with `scjn-tesis`.","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional words to match in the title and text of the tesis."},"tesis_type":{"type":"string","enum":["any","jurisprudencia","aislada"],"default":"any","description":"Filter by tesis type: binding `jurisprudencia`, non-binding `aislada`, or `any`."},"subject":{"type":"string","maxLength":60,"default":"","description":"Optional subject filter (e.g. `Civil`, `Constitucional`)."},"epoch":{"type":"string","default":"","description":"Optional época number filter (`5` through `12`)."},"year":{"type":"string","default":"","description":"Optional 4-digit year filter."},"instance":{"type":"string","maxLength":80,"default":"","description":"Optional deciding level, exactly as the source names it (e.g. `Suprema Corte de Justicia de la Nación`, `Tribunales Colegiados de Circuito`, `Plenos Regionales`)."},"court":{"type":"string","maxLength":200,"default":"","description":"Optional court or chamber, exactly as `court` reads in results (e.g. `Primera Sala`, `Pleno`)."},"formation":{"type":"string","maxLength":120,"default":"","description":"Optional way the criterion was formed, exactly as the source names it (e.g. `Reiteración`, `Contradicción de criterios (antes contradicción de tesis)`)."},"published_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"published_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"updated_after":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50). Every result carries the full text of the tesis."}},"example_request":{"query":"interés usurario","tesis_type":"jurisprudencia"}},{"id":"scjn-tesis","name":"SCJN Tesis","method":"POST","path":"/mx/scjn/tesis/v1","url":"https://api.croma.run/mx/scjn/tesis/v1","docs_url":"https://docs.usecroma.com/guides/mexico/scjn","country":"Mexico","source":"SCJN","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Retrieve one tesis by its registro digital (`registration_number`), including the full text, citation (clave, época, localización), subjects, precedent notes, and linked ruling ids.","required":["registration_number"],"request_schema":{"registration_number":{"type":"string","pattern":"^\\d{4,10}$","description":"Registro digital of the tesis (`registration_number` from search)."}},"example_request":{"registration_number":"2001360"}},{"id":"scjn-tesis-browse","name":"SCJN Tesis Browse","method":"POST","path":"/mx/scjn/tesis-browse/v1","url":"https://api.croma.run/mx/scjn/tesis-browse/v1","docs_url":"https://docs.usecroma.com/guides/mexico/scjn","country":"Mexico","source":"SCJN","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":false,"description":"Same request and response as `scjn-tesis-search`, which replaces it: the Mexican Supreme Court's case law in full, filtered by words in the title and text, binding force, subject, época, year, instance, court, formation, publication window and the court's modification date. Newest first, pages of up to 20 full records, with `as_of`.","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional words to match in the title and text of the tesis."},"tesis_type":{"type":"string","enum":["any","jurisprudencia","aislada"],"default":"any","description":"Filter by tesis type: binding `jurisprudencia`, non-binding `aislada`, or `any`."},"subject":{"type":"string","maxLength":60,"default":"","description":"Optional subject filter (e.g. `Civil`, `Constitucional`)."},"epoch":{"type":"string","default":"","description":"Optional época number filter (`5` through `12`)."},"year":{"type":"string","default":"","description":"Optional 4-digit year filter."},"instance":{"type":"string","maxLength":80,"default":"","description":"Optional deciding level, exactly as the source names it (e.g. `Suprema Corte de Justicia de la Nación`, `Tribunales Colegiados de Circuito`, `Plenos Regionales`)."},"court":{"type":"string","maxLength":200,"default":"","description":"Optional court or chamber, exactly as `court` reads in results (e.g. `Primera Sala`, `Pleno`)."},"formation":{"type":"string","maxLength":120,"default":"","description":"Optional way the criterion was formed, exactly as the source names it (e.g. `Reiteración`, `Contradicción de criterios (antes contradicción de tesis)`)."},"published_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"published_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"updated_after":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":20,"default":10,"description":"Results per page (1-20). Every result carries the full text of the tesis."}},"example_request":{"subject":"Civil","tesis_type":"jurisprudencia","published_from":"2026-01-01"},"deprecated":{"since":"2026-09-07","sunset":"2026-12-15","successor_url":"https://api.croma.run/mx/scjn/tesis-search/v1"}},{"id":"banxico-circulars","name":"Banxico Circulars","method":"POST","path":"/mx/banxico/circulars/v1","url":"https://api.croma.run/mx/banxico/circulars/v1","docs_url":"https://docs.usecroma.com/guides/mexico/banxico","country":"Mexico","source":"Banco de México","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"The chronological index of every circular and disposición issued by Banco de México (1,200+ entries back to 1969), each with subject, abrogation status, and which base circular it modifies. One row per index entry: a circular amending several bases appears once per base. Optional `year` filters one year. Paged, 100 per page; drill into one with `banxico-circular`.","required":[],"request_schema":{"year":{"type":"string","default":"","description":"Optional 4-digit year filter."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"year":"2026"}},{"id":"banxico-circular","name":"Banxico Circular","method":"POST","path":"/mx/banxico/circular/v1","url":"https://api.croma.run/mx/banxico/circular/v1","docs_url":"https://docs.usecroma.com/guides/mexico/banxico","country":"Mexico","source":"Banco de México","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"One Banco de México circular in full, by its `number`: subject, obligated entities, the consolidated (compiled) text PDF, the original text PDF with its DOF date, and every modification with dates and PDFs. Amendment circulars have no page of their own: looking one up returns the amended base circular (its `number` says which), whose modifications list carries the requested número.","required":["number"],"request_schema":{"number":{"type":"string","minLength":1,"maxLength":80,"description":"Circular number as listed (e.g. `3/2012`, `E-126/2013`). Matching is case-insensitive."}},"example_request":{"number":"3/2012"}},{"id":"cnbv-regulations","name":"CNBV Regulations","method":"POST","path":"/mx/cnbv/regulations/v1","url":"https://api.croma.run/mx/cnbv/regulations/v1","docs_url":"https://docs.usecroma.com/guides/mexico/cnbv","country":"Mexico","source":"CNBV","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"The CNBV's current regulatory catalog (~113 normas: leyes, disposiciones de carácter general including the Circular Única de Bancos, circulares, acuerdos, reglas), each with type, DOF publication date, applicable sectors, and the official PDF. Optional `query` filters by name. Paged, 50 per page. Norms with a `regulation_id` have modification history via `cnbv-regulation-history`.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional name filter (case- and accent-insensitive substring)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"query":"instituciones de crédito"}},{"id":"cnbv-regulation-history","name":"CNBV Regulation History","method":"POST","path":"/mx/cnbv/regulation-history/v1","url":"https://api.croma.run/mx/cnbv/regulation-history/v1","docs_url":"https://docs.usecroma.com/guides/mexico/cnbv","country":"Mexico","source":"CNBV","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Every modifying resolución and annex for one CNBV norma (by `regulation_id` from `cnbv-regulations`), each with its DOF date and official PDF. The Circular Única de Bancos alone carries 180+ modifications.","required":["regulation_id"],"request_schema":{"regulation_id":{"type":"string","pattern":"^\\d{1,10}$","description":"Norm identifier returned by the regulations list (`regulation_id`)."}},"example_request":{"regulation_id":"1024"}},{"id":"cnsf-provisions-search","name":"CNSF Provisions Search","method":"POST","path":"/mx/cnsf/provisions-search/v1","url":"https://api.croma.run/mx/cnsf/provisions-search/v1","docs_url":"https://docs.usecroma.com/guides/mexico/cnsf","country":"Mexico","source":"CNSF","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search Mexico's insurance and surety rulebook in full: every artículo of the Ley de Instituciones de Seguros y de Fianzas (LISF), and every disposición, anexo, anexo transitorio and transitional provision of the Circular Única de Seguros y de Fianzas (CUSF), plus the documentation the circular points to. Filter by free text, `instrument`, `kind`, exact `number`, `chapter_number`, `source_circular` (which Circular Modificatoria introduced a transitional provision), and when the containing chapter was last amended (`amended_from`/`amended_to`). Results come back in reading order with the complete text. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the text and headings of the provisions."},"instrument":{"type":"string","enum":["any","LISF","CUSF"],"default":"any","description":"Instrument: `LISF` (the law), `CUSF` (the circular that implements it), or `any` for both."},"kind":{"type":"string","enum":["any","articulo","disposicion","anexo","transitoria","anexo_transitorio","capitulo","documento"],"default":"any","description":"Kind of provision: `articulo` (LISF), `disposicion`, `anexo`, `anexo_transitorio` or `documento` (CUSF), `transitoria` (either), `capitulo` for a chapter repealed in full, or `any`."},"number":{"type":"string","maxLength":40,"default":"","description":"Optional exact provision number as the instrument writes it (e.g. `41` for a LISF artículo, `3.1.2` for a CUSF disposición, `14.2.1-a` for an annex)."},"chapter_number":{"type":"string","maxLength":20,"default":"","description":"Optional chapter filter (e.g. `6.3` in the CUSF)."},"source_circular":{"type":"string","maxLength":20,"default":"","description":"Optional filter for transitional provisions by the Circular Modificatoria that introduced them (e.g. `3/26`), or `original` for those issued with the instrument itself."},"amended_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"amended_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":25,"default":10,"description":"Results per page (1-25). Every result carries the full text of the provision."}},"example_request":{"query":"requerimiento de capital","instrument":"CUSF"}},{"id":"cnsf-provision","name":"CNSF Provision","method":"POST","path":"/mx/cnsf/provision/v1","url":"https://api.croma.run/mx/cnsf/provision/v1","docs_url":"https://docs.usecroma.com/guides/mexico/cnsf","country":"Mexico","source":"CNSF","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one provision of Mexico's insurance and surety rulebook by its `provision_id` from the search results (e.g. `cusf:disp:3.1.2`, `lisf:art:41`, `cusf:anexo:14.2.1-a`), with its full text and the chapter it sits in.","required":["provision_id"],"request_schema":{"provision_id":{"type":"string","minLength":3,"maxLength":80,"description":"Provision identifier from the search results (`id`), e.g. `cusf:disp:3.1.2`, `lisf:art:41`, `cusf:anexo:14.2.1-a`."}},"example_request":{"provision_id":"cusf:disp:3.1.2"}},{"id":"cnsf-amendments","name":"CNSF Amendments","method":"POST","path":"/mx/cnsf/amendments/v1","url":"https://api.croma.run/mx/cnsf/amendments/v1","docs_url":"https://docs.usecroma.com/guides/mexico/cnsf","country":"Mexico","source":"CNSF","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Track how Mexico's Circular Única de Seguros y de Fianzas has changed: every Circular Modificatoria the commission has published since 2014, most recent first, with what it changed, the chapters and annexes it touched, and the Diario Oficial publication behind it. Filter by free text, by `chapter_number`, and by publication window.","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the text and headings of the provisions."},"chapter_number":{"type":"string","maxLength":20,"default":"","description":"Optional chapter filter (e.g. `6.3` in the CUSF)."},"published_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"published_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":25,"default":10,"description":"Results per page (1-25). Every result carries the full text of the provision."}},"example_request":{"chapter_number":"6.3"}},{"id":"diputados-federal-laws","name":"Mexican Federal Laws","method":"POST","path":"/mx/diputados/federal-laws/v1","url":"https://api.croma.run/mx/diputados/federal-laws/v1","docs_url":"https://docs.usecroma.com/guides/mexico/diputados","country":"Mexico","source":"Cámara de Diputados","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"The Cámara de Diputados catalog of federal laws and codes (315+), each with its official name, abbreviation, original DOF publication date, most recent reform date, consolidated PDF/DOC text, and whether it is still in force. Optional `query` filters by name or abbreviation. Paged, 100 per page; drill into one with `diputados-federal-law`.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional name filter (case- and accent-insensitive substring)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"query":"instituciones de crédito"}},{"id":"diputados-federal-law","name":"Mexican Federal Law","method":"POST","path":"/mx/diputados/federal-law/v1","url":"https://api.croma.run/mx/diputados/federal-law/v1","docs_url":"https://docs.usecroma.com/guides/mexico/diputados","country":"Mexico","source":"Cámara de Diputados","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"One Mexican federal law in full by its `law_id`: current consolidated text (PDF/DOC), original DOF publication with its scan, and every reform decree that amended it, newest first, each with its DOF date, headline, documents, and any fe de erratas.","required":["law_id"],"request_schema":{"law_id":{"type":"string","pattern":"^[A-Za-z0-9_]{2,60}$","description":"Law identifier returned by the federal-laws list (`id`)."}},"example_request":{"law_id":"lic"}},{"id":"diputados-federal-regulations","name":"Mexican Federal Regulations","method":"POST","path":"/mx/diputados/federal-regulations/v1","url":"https://api.croma.run/mx/diputados/federal-regulations/v1","docs_url":"https://docs.usecroma.com/guides/mexico/diputados","country":"Mexico","source":"Cámara de Diputados","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"The Cámara de Diputados catalog of federal reglamentos (135+), each with its DOF publication date, consolidated text, whether it is still in force, and an inline history of reforms, annual amount updates, erratas and vigencia notices. Optional `query` filters by name. Paged, 50 per page.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional name filter (case- and accent-insensitive substring)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"query":"ley aduanera"}},{"id":"diputados-law-reforms","name":"Mexican Law Reforms by Year","method":"POST","path":"/mx/diputados/law-reforms/v1","url":"https://api.croma.run/mx/diputados/law-reforms/v1","docs_url":"https://docs.usecroma.com/guides/mexico/diputados","country":"Mexico","source":"Cámara de Diputados","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Every reform decree published in the DOF in one year, from the Cámara de Diputados reform log: the decree prose, the canonical actions it takes (reforman, adicionan, derogan, abrogan, expiden...), and every law it touches. One entry per publication day; a single day can bundle several instruments. Defaults to the current year. Paged, 50 decrees per page.","required":[],"request_schema":{"year":{"type":"string","default":"","description":"Optional 4-digit year filter."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"year":"2026"}},{"id":"siem-establishments","name":"SIEM Establishments Search","method":"POST","path":"/mx/siem/establishments/v1","url":"https://api.croma.run/mx/siem/establishments/v1","docs_url":"https://docs.usecroma.com/guides/mexico/siem","country":"Mexico","source":"SIEM","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search Mexican business establishments in the SIEM directory by commercial name or razón social. Optional filters narrow by state (INEGI code) and SCIAN activity. SIEM is a self-declared directory: registration is voluntary and each establishment chooses which fields stay public, so absence is not evidence of anything. Drill into a result with `siem-establishment`.","required":["name"],"request_schema":{"name":{"type":"string","minLength":2,"maxLength":200,"description":"Commercial name or razón social to search for. Matched case-insensitively as a substring."},"state_code":{"type":"integer","minimum":0,"maximum":32,"default":0,"description":"INEGI state code (1-32) to filter by. Omit or 0 searches all states."},"activity_code":{"type":"integer","minimum":0,"maximum":999999,"default":0,"description":"SCIAN activity code to filter by (exact match). Omit or 0 searches all activities."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."}},"example_request":{"name":"OXXO","state_code":21}},{"id":"siem-establishment","name":"SIEM Establishment","method":"POST","path":"/mx/siem/establishment/v1","url":"https://api.croma.run/mx/siem/establishment/v1","docs_url":"https://docs.usecroma.com/guides/mexico/siem","country":"Mexico","source":"SIEM","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Retrieve one SIEM establishment's declared profile: RFC, legal or personal name, commercial name, activity, address and contact, headcount, import/export flags, declared products and services, and registration status. Returns `found: false` when the id is unknown.","required":["establishment_id"],"request_schema":{"establishment_id":{"type":"string","pattern":"^[A-Za-z0-9]{1,40}$","description":"Establishment id returned by the search (`establishment_id`)."}},"example_request":{"establishment_id":"3417757"}},{"id":"rree-foreigner-cards","name":"RREE Foreigner Cards","method":"POST","path":"/pe/rree/foreigner-cards/v1","url":"https://api.croma.run/pe/rree/foreigner-cards/v1","docs_url":"https://docs.usecroma.com/guides/peru/rree","country":"Peru","source":"RREE","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Verify a Peruvian foreigner identity card (carné de extranjería) by its 8-digit card number: names, nationality, immigration status, and expiration. `found: false` when no card matches.","required":["document_number"],"request_schema":{"document_number":{"type":"string","pattern":"^\\d{8}$","description":"8-digit foreigner card number."}},"example_request":{"document_number":"00112233"}},{"id":"apeseg-soat","name":"APESEG SOAT Certificate History","method":"POST","path":"/pe/apeseg/soat/v1","url":"https://api.croma.run/pe/apeseg/soat/v1","docs_url":"https://docs.usecroma.com/guides/peru/apeseg-soat","country":"Peru","source":"APESEG","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up a vehicle plate's SOAT (mandatory traffic-accident insurance) certificate history from APESEG (Asociación Peruana de Empresas de Seguros). `has_active_soat: true` means a currently valid (VIGENTE) certificate exists, returned as `active`; `certificates` lists the full history. `found: false` when the plate has no SOAT record.","required":["plate"],"request_schema":{"plate":{"type":"string","pattern":"^[A-Za-z0-9-]{4,10}$","description":"The vehicle plate to look up (4-10 characters)."}},"example_request":{"plate":"ABC123"}},{"id":"sunarp-registry-search","name":"SUNARP Registry Search","method":"POST","path":"/pe/sunarp/registry-search/v1","url":"https://api.croma.run/pe/sunarp/registry-search/v1","docs_url":"https://docs.usecroma.com/guides/peru/sunarp","country":"Peru","source":"SUNARP","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search one SUNARP registry office (e.g. `LIMA`) and registry (`vehicles`, `real_estate`, `legal_entities`, ...) by partida, plate or ficha number. Returns the matching partidas with their zone, office and status; for vehicles also the plate and vehicle status. Pass a `partida_number` to `sunarp-registry-entry` for its inscriptions and pages. `found: false` when nothing matches.","required":["office","registry_area","number"],"request_schema":{"office":{"type":"string","minLength":2,"maxLength":60,"description":"The registry office (oficina registral) by name, e.g. `LIMA`, `AREQUIPA`, `CUSCO`. Case and accents are ignored."},"registry_area":{"type":"string","enum":["real_estate","non_land_property","legal_entities","natural_persons","vehicles","mining","vessels","aircraft","movable_contracts"],"description":"The registry: `real_estate` (propiedad inmueble predial), `non_land_property` (propiedad inmueble no predial), `legal_entities` (personas jurídicas), `natural_persons` (personas naturales), `vehicles` (propiedad vehicular), `mining` (propiedad minera), `vessels` (naves y embarcaciones), `aircraft` (aeronaves) or `movable_contracts` (registro mobiliario de contratos)."},"search_by":{"type":"string","enum":["partida","plate","ficha"],"default":"partida","description":"What `number` is: `partida` (the registry entry number, the default), `plate` (vehicles only) or `ficha` (the older card number, every registry except vehicles). A partida starting with P is written as `P12345678`."},"number":{"type":"string","minLength":3,"maxLength":12,"pattern":"^[A-Za-z0-9][A-Za-z0-9 -]{1,10}[A-Za-z0-9]$","description":"The partida, plate or ficha number, e.g. `53237569` or `AKI774`. Spaces and hyphens are ignored."},"connection_id":{"type":"string","default":"","description":"Optional. Run as this connection (`conn_…`). Empty lets Croma pick among your organization's connections, moving to the next one when one reaches its daily allowance."}},"example_request":{"office":"LIMA","registry_area":"vehicles","search_by":"plate","number":"ABC123"}},{"id":"sunarp-registry-entry","name":"SUNARP Registry Entry","method":"POST","path":"/pe/sunarp/registry-entry/v1","url":"https://api.croma.run/pe/sunarp/registry-entry/v1","docs_url":"https://docs.usecroma.com/guides/peru/sunarp","country":"Peru","source":"SUNARP","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Read one SUNARP partida: its inscriptions (asientos), newest first, with act, date, title and section, the older cards and book folios it continues from, and every page as a PDF we keep (`document_url`). Take `office`, `registry_area` and `partida_number` from a `sunarp-registry-search` result. `found: false` when the office has no such partida; `has_images: false` when SUNARP shows no pages for it (vehicle partidas: for a vehicle's characteristics and owners use `sunarp-vehicular-vehicle-by-plate`).","required":["office","registry_area","partida_number"],"request_schema":{"office":{"type":"string","minLength":2,"maxLength":60,"description":"The registry office (oficina registral) by name, e.g. `LIMA`, `AREQUIPA`, `CUSCO`. Case and accents are ignored."},"registry_area":{"type":"string","enum":["real_estate","non_land_property","legal_entities","natural_persons","vehicles","mining","vessels","aircraft","movable_contracts"],"description":"The registry: `real_estate` (propiedad inmueble predial), `non_land_property` (propiedad inmueble no predial), `legal_entities` (personas jurídicas), `natural_persons` (personas naturales), `vehicles` (propiedad vehicular), `mining` (propiedad minera), `vessels` (naves y embarcaciones), `aircraft` (aeronaves) or `movable_contracts` (registro mobiliario de contratos)."},"partida_number":{"type":"string","minLength":3,"maxLength":12,"pattern":"^[A-Za-z0-9][A-Za-z0-9 -]{1,10}[A-Za-z0-9]$","description":"The partida number from a search result, e.g. `53237569`. A partida starting with P is written as `P12345678`."},"connection_id":{"type":"string","default":"","description":"Optional. Run as this connection (`conn_…`). Empty lets Croma pick among your organization's connections, moving to the next one when one reaches its daily allowance."}},"example_request":{"office":"LIMA","registry_area":"real_estate","partida_number":"12345678"}},{"id":"sunarp-vehicular-vehicle-by-plate","name":"SUNARP Vehicle by Plate","method":"POST","path":"/pe/sunarp-vehicular/vehicle-by-plate/v1","url":"https://api.croma.run/pe/sunarp-vehicular/vehicle-by-plate/v1","docs_url":"https://docs.usecroma.com/guides/peru/sunarp-vehicular","country":"Peru","source":"SUNARP","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up a vehicle in SUNARP's vehicle registry by plate: make, model, model year, color, engine number, serial number and VIN, plate in force and previous plate, status, annotations summary, theft alert, current owners (names) and the registry office and partida number. Includes a stored copy of the record SUNARP returned. `found: false` when no vehicle has that plate.","required":["plate"],"request_schema":{"plate":{"type":"string","pattern":"^[A-Za-z0-9-]{4,10}$","description":"The vehicle plate to look up (4-10 characters; hyphens and spaces are ignored)."}},"example_request":{"plate":"ABC123"}},{"id":"sbs-soat","name":"SBS SOAT, CAT and Vehicle Insurance Report","method":"POST","path":"/pe/sbs/soat/v1","url":"https://api.croma.run/pe/sbs/soat/v1","docs_url":"https://docs.usecroma.com/guides/peru/sbs-soat","country":"Peru","source":"SBS","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up a Peruvian vehicle plate's SOAT, CAT and vehicle insurance reports from SBS (Superintendencia de Banca, Seguros y AFP), Peru's banking and insurance regulator, in one call. The top level is SOAT (mandatory traffic-accident insurance): `accident_count` (accidents covered in the last 5 years), `policies` (issuing company, vehicle class/use, accidents per policy, policy/certificate number, coverage window, status VIGENTE/VENCIDA/ANULADA, annulment date and reason, rectification date), `has_active_soat` with the current policy as `active`, and `coverages`. `vehicle_insurance` is the private Seguro Vehicular report with the same policy shape and `has_active_policy`. `cat` is the CAT report (certificates AFOCATs issue to public transport vehicles), with `certificates`, `has_active_cat` and `coverages`. `found: false` at any level means that report has nothing on record for the plate.","required":["plate"],"request_schema":{"plate":{"type":"string","pattern":"^[A-Za-z0-9-]{4,10}$","description":"The vehicle plate to look up (4-10 characters)."}},"example_request":{"plate":"ABC123"}},{"id":"sutran-infracciones","name":"SUTRAN Infraction Record","method":"POST","path":"/pe/sutran/infracciones/v1","url":"https://api.croma.run/pe/sutran/infracciones/v1","docs_url":"https://docs.usecroma.com/guides/peru/sutran-infracciones","country":"Peru","source":"SUTRAN","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up the infraction documents (papeletas and other actos) on record for a vehicle plate from SUTRAN (Superintendencia de Transporte Terrestre de Personas, Carga y Mercancías), Peru's national road-transport authority. `has_infractions: false` means the plate has no infractions on record. When infractions exist, `infractions` lists each one (document number, type, date, infraction code, classification).","required":["plate"],"request_schema":{"plate":{"type":"string","pattern":"^[A-Za-z0-9-]{4,10}$","description":"The vehicle plate to look up (4-10 characters)."}},"example_request":{"plate":"ABC123"}},{"id":"callao-papeletas","name":"Callao Traffic Tickets","method":"POST","path":"/pe/callao/papeletas/v1","url":"https://api.croma.run/pe/callao/papeletas/v1","docs_url":"https://docs.usecroma.com/guides/peru/callao-papeletas","country":"Peru","source":"Municipalidad Provincial del Callao","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"List the outstanding traffic tickets (papeletas) registered against a vehicle plate in the province of Callao, issued by the Municipalidad Provincial del Callao. `has_papeletas: false` means the plate has no outstanding tickets on record. When tickets exist, `papeletas` lists each one (code, ticket number, infraction date, amount, installment) and `total` is the sum of the outstanding amounts in PEN.","required":["plate"],"request_schema":{"plate":{"type":"string","pattern":"^[A-Za-z0-9-]{4,10}$","description":"The vehicle plate to look up (4-10 characters)."}},"example_request":{"plate":"ABC123"}},{"id":"sat-lima-account-status","name":"SAT Lima Account Status","method":"POST","path":"/pe/sat-lima/account-status/v1","url":"https://api.croma.run/pe/sat-lima/account-status/v1","docs_url":"https://docs.usecroma.com/guides/peru/sat-lima","country":"Peru","source":"SAT Lima","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up outstanding debt owed to the SAT de Lima (Servicio de Administración Tributaria de Lima) for a person, company, or vehicle. Pass `document_type` (`dni`, `ruc`, `placa`, `papeleta`, `cod_administrado`, or `compromiso`; defaults to `dni`) plus `document_number`. Returns each outstanding item (taxes such as impuesto vehicular / predial / arbitrios, traffic tickets, administrative fines, and payment commitments) with its group, reference, amount, status, and relevant dates, plus the account total. `clear: true` means nothing is outstanding.","required":["document_number"],"request_schema":{"document_type":{"type":"string","enum":["dni","ruc","placa","papeleta","cod_administrado","compromiso"],"default":"dni","description":"Search dimension: `dni`, `ruc`, `placa` (vehicle plate), `papeleta` (ticket / administrative-fine document), `cod_administrado` (administered-party code), or `compromiso` (payment-commitment code). Defaults to `dni`."},"document_number":{"type":"string","pattern":"^[A-Za-z0-9-]{1,20}$","description":"The value to look up (1-20 alphanumeric characters)."}},"example_request":{"document_type":"placa","document_number":"ABC123"}},{"id":"sat-lima-capturas","name":"SAT Lima Vehicle Capture Orders","method":"POST","path":"/pe/sat-lima/capturas/v1","url":"https://api.croma.run/pe/sat-lima/capturas/v1","docs_url":"https://docs.usecroma.com/guides/peru/sat-lima-capturas","country":"Peru","source":"SAT Lima","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Check whether a vehicle plate has an outstanding capture order (orden de captura) in the province of Lima, issued by the SAT de Lima (Servicio de Administración Tributaria de Lima) for unpaid tax debt or traffic tickets. `has_capture_order: false` means the plate has no capture order on record. When an order exists, `orders` lists each one with the fields the source reports.","required":["plate"],"request_schema":{"plate":{"type":"string","pattern":"^[A-Za-z0-9-]{4,10}$","description":"The vehicle plate to look up (4-10 characters)."}},"example_request":{"plate":"ABC123"}},{"id":"runt-vehicle-by-plate","name":"RUNT Vehicle by Plate","method":"POST","path":"/co/runt/vehicle-by-plate/v1","url":"https://api.croma.run/co/runt/vehicle-by-plate/v1","docs_url":"https://docs.usecroma.com/guides/colombia/runt","country":"Colombia","source":"RUNT","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Resolve a Colombian vehicle in RUNT (Registro Único Nacional de Tránsito) by plate and the registered owner's document. Returns the vehicle record (brand, line, model year, class, body, color, engine displacement, fuel, weights, VIN, engine/chassis/serial numbers, traffic authority, registration dates, lien/pledge flags) plus SOAT insurance history, técnico-mecánica (RTM) inspection history, extended technical data, registered guarantees/liens (with the creditor, e.g. a financing bank), ownership limitations, armoring (blindaje) status, civil-liability policies, DIJIN and scrapping certificates, normalization records, and scrapping status. `document_type` defaults to `CC`. `found: false` when the plate and owner document have no active match.","required":["plate","document_number"],"request_schema":{"plate":{"type":"string","minLength":6,"maxLength":6,"pattern":"^[A-Za-z]{3}\\d{2}[A-Za-z0-9]$","description":"Colombian vehicle plate, e.g. `ABC123` or `ABC12D`."},"document_type":{"type":"string","enum":["CC","CE","TI","RC","PA","NIT","PPT"],"default":"CC","description":"Colombian document type. Defaults to `CC`."},"document_number":{"type":"string","minLength":3,"maxLength":30,"description":"Document number (alphanumeric with hyphens allowed)."}},"example_request":{"plate":"ABC123","document_type":"CC","document_number":"1234567890"}},{"id":"runt-vehicle-history-by-plate","name":"RUNT Vehicle History by Plate","method":"POST","path":"/co/runt/vehicle-history-by-plate/v1","url":"https://api.croma.run/co/runt/vehicle-history-by-plate/v1","docs_url":"https://docs.usecroma.com/guides/colombia/runt","country":"Colombia","source":"RUNT","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up a Colombian vehicle's history in RUNT (Registro Único Nacional de Tránsito) by plate alone, without the owner's document. Returns the registered owner(s) (name and identification number), the vehicle characteristics (brand, line, model year, class, body, color, VIN, engine/chassis/serial numbers), the traffic-license and import records, SOAT and técnico-mecánica (RTM) history, any accident on record, recent and pending procedures (trámites), and guarantee/lien and ownership-limitation summaries. `found: false` when the plate has no record.","required":["plate"],"request_schema":{"plate":{"type":"string","minLength":6,"maxLength":6,"pattern":"^[A-Za-z]{3}\\d{2}[A-Za-z0-9]$","description":"Colombian vehicle plate, e.g. `ABC123` or `ABC12D`."}},"example_request":{"plate":"ABC123"}},{"id":"runt-citizen-by-document","name":"RUNT Citizen by Document","method":"POST","path":"/co/runt/citizen-by-document/v1","url":"https://api.croma.run/co/runt/citizen-by-document/v1","docs_url":"https://docs.usecroma.com/guides/colombia/runt","country":"Colombia","source":"RUNT","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up a person in RUNT (Registro Único Nacional de Tránsito) by identification document: the driver record (name, registration id and date, person and driver status), every driving licence with its categories, issue and expiry dates, restrictions, retention, suspension and cancellation, traffic-fine standing (paz y salvo), procedure requests (solicitudes), driving-aptitude and medical certificates with their detail, CUPL registrations, SICOV validations, ANSV payments and identity-validation history. `document_type` defaults to `CC`. `first_surname` is optional: when omitted, the surname on record is used. `found: false` when the registry has no record for the document.","required":["document_number"],"request_schema":{"document_type":{"type":"string","enum":["CC","CE","TI","RC","PA","PPT"],"default":"CC","description":"Colombian document type. Defaults to `CC`."},"document_number":{"type":"string","minLength":3,"maxLength":30,"description":"Document number (alphanumeric with hyphens allowed)."},"first_surname":{"type":"string","maxLength":60,"default":"","description":"First surname (primer apellido). Optional: when omitted, the surname on record is used."}},"example_request":{"document_type":"CC","document_number":"1234567890"}},{"id":"runt-citizen-by-plate","name":"RUNT Citizen by Plate","method":"POST","path":"/co/runt/citizen-by-plate/v1","url":"https://api.croma.run/co/runt/citizen-by-plate/v1","docs_url":"https://docs.usecroma.com/guides/colombia/runt","country":"Colombia","source":"RUNT","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up the current registered owner of a Colombian vehicle in RUNT (Registro Único Nacional de Tránsito) by plate alone, and return that person's citizen record: the driver record, driving licences with categories, traffic-fine standing, procedure requests, driving-aptitude and medical certificates, CUPL registrations, SICOV validations, ANSV payments and identity validation. The owner (document type, number and name) is echoed in `owner`. `found: false` when the plate has no current natural-person owner or the owner has no record.","required":["plate"],"request_schema":{"plate":{"type":"string","minLength":6,"maxLength":6,"pattern":"^[A-Za-z]{3}\\d{2}[A-Za-z0-9]$","description":"Colombian vehicle plate, e.g. `ABC123` or `ABC12D`."}},"example_request":{"plate":"ABC123"}},{"id":"consejo-estado-search","name":"Consejo de Estado Jurisprudence Search","method":"POST","path":"/co/consejo-estado/search/v1","url":"https://api.croma.run/co/consejo-estado/search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/consejo-estado","country":"Colombia","source":"Consejo de Estado","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search the Relatoría del Consejo de Estado's traditional jurisprudence corpus (broadly providencias before December 2021) by section, type, date window, radicado, ponente, party or challenged rule. Each row carries the providencia's metadata plus a `url` permalink to feed to `consejo-estado-providencia`. For December 2021 onward use the SAMAI endpoints.","required":[],"request_schema":{"section":{"type":"string","maxLength":80,"default":"","description":"Optional section filter (e.g. `SECCION TERCERA`, `SALA PLENA`). Empty means all sections."},"type":{"type":"string","enum":["","AUTO","CONCEPTO","SENTENCIA"],"default":"","description":"Filter by providencia type; empty means any."},"registration_number":{"type":"string","maxLength":40,"default":"","description":"Optional número de proceso (radicado) filter."},"reporting_judge":{"type":"string","maxLength":120,"default":"","description":"Optional consejero ponente filter."},"plaintiff":{"type":"string","maxLength":120,"default":"","description":"Optional demandante (actor) filter."},"defendant":{"type":"string","maxLength":120,"default":"","description":"Optional demandado filter."},"statute":{"type":"string","maxLength":120,"default":"","description":"Optional norma o acto demandado filter."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":20,"default":5,"description":"Results per page (max 20). The source returns one record per view, so larger pages take proportionally longer."}},"example_request":{"section":"SECCION TERCERA","type":"SENTENCIA","from_date":"2020-01-01","to_date":"2020-12-31"}},{"id":"consejo-estado-providencia","name":"Consejo de Estado Providencia","method":"POST","path":"/co/consejo-estado/providencia/v1","url":"https://api.croma.run/co/consejo-estado/providencia/v1","docs_url":"https://docs.usecroma.com/guides/colombia/consejo-estado","country":"Colombia","source":"Consejo de Estado","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Retrieve the full text of one providencia from the Relatoría del Consejo de Estado, by the `url` permalink a search row exposes. `found: false` when the permalink resolves to no document.","required":["url"],"request_schema":{"url":{"type":"string","format":"uri","maxLength":2048,"description":"Content permalink (`url`) returned by a search result row."}},"example_request":{"url":"https://servicios.consejodeestado.gov.co/WebRelatoria/FileReferenceServlet?corp=ce&ext=html&file=233679"}},{"id":"sicaac-insolvency-cases","name":"SICAAC Insolvency Cases","method":"POST","path":"/co/sicaac/insolvency-cases/v1","url":"https://api.croma.run/co/sicaac/insolvency-cases/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sicaac","country":"Colombia","source":"SICAAC","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up Colombian natural-person insolvency cases by document number. `document_type` defaults to `CC` (Cédula de Ciudadanía).","required":["document_number"],"request_schema":{"document_type":{"type":"string","enum":["CC","CE","TI","RC","PA","NIT","NA","NIE","DEC"],"default":"CC","description":"Colombian document type. Defaults to `CC`."},"document_number":{"type":"string","minLength":3,"maxLength":30,"description":"Document number (alphanumeric with hyphens allowed)."}},"example_request":{"document_number":"1020745812"}},{"id":"contaduria-state-delinquent-debtors","name":"Contaduría State Delinquent Debtor Records","method":"POST","path":"/co/contaduria/state-delinquent-debtors/v1","url":"https://api.croma.run/co/contaduria/state-delinquent-debtors/v1","docs_url":"https://docs.usecroma.com/guides/colombia/contaduria","country":"Colombia","source":"Contaduría","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Check whether a person or entity is a delinquent debtor to the Colombian State, from the Contaduría General de la Nación's register (Boletín de Deudores Morosos del Estado). Returns two verdicts: delinquent debt owed to the State (Ley 901 de 2004) and default on a payment agreement (Ley 1066 de 2006). `document_type` defaults to `CC`.","required":["document_number"],"request_schema":{"document_type":{"type":"string","enum":["CC","NIT","TI","CE","PA","RC","PPT"],"default":"CC","description":"Colombian document type. Defaults to `CC`."},"document_number":{"type":"string","minLength":3,"maxLength":30,"description":"Document number (alphanumeric with hyphens allowed)."}},"example_request":{"document_number":"1234567890"}},{"id":"sunat-ruc","name":"SUNAT Taxpayer by RUC","method":"POST","path":"/pe/sunat/ruc/v1","url":"https://api.croma.run/pe/sunat/ruc/v1","docs_url":"https://docs.usecroma.com/guides/peru/sunat","country":"Peru","source":"SUNAT","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up a Peruvian taxpayer's full record by RUC (11 digits). `found: false` when the RUC is not registered.","required":["ruc"],"request_schema":{"ruc":{"type":"string","pattern":"^\\d{11}$","description":"11-digit RUC."}},"example_request":{"ruc":"20100070970"}},{"id":"sunat-document","name":"SUNAT Taxpayer by Document","method":"POST","path":"/pe/sunat/document/v1","url":"https://api.croma.run/pe/sunat/document/v1","docs_url":"https://docs.usecroma.com/guides/peru/sunat","country":"Peru","source":"SUNAT","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up a Peruvian taxpayer's full record by identity document (DNI, carné de extranjería, passport, or diplomatic card). `found: false` when no taxpayer matches.","required":["document_number"],"request_schema":{"document_type":{"type":"string","enum":["dni","ce","passport","diplomatic"],"default":"dni","description":"Identity document type: `dni`, `ce` (carné de extranjería), `passport`, or `diplomatic`. Defaults to `dni`."},"document_number":{"type":"string","pattern":"^[A-Za-z0-9]{6,16}$","description":"Identity document number (6-16 alphanumeric characters)."}},"example_request":{"document_type":"dni","document_number":"12345678"}},{"id":"sunat-name","name":"SUNAT Taxpayer Search by Name","method":"POST","path":"/pe/sunat/name/v1","url":"https://api.croma.run/pe/sunat/name/v1","docs_url":"https://docs.usecroma.com/guides/peru/sunat","country":"Peru","source":"SUNAT","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search Peruvian taxpayers by name or razón social. Returns up to 30 matches (SUNAT's cap).","required":["name"],"request_schema":{"name":{"type":"string","minLength":3,"maxLength":100,"description":"Taxpayer name or razón social to search for."}},"example_request":{"name":"INVERSIONES GENERALES"}},{"id":"oece-processes-search","name":"OECE Processes Search","method":"POST","path":"/pe/oece/processes-search/v1","url":"https://api.croma.run/pe/oece/processes-search/v1","docs_url":"https://docs.usecroma.com/guides/peru/oece","country":"Peru","source":"OECE Contrataciones Abiertas","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search Peru's public-procurement procedures (SEACE, published by OECE) by free text over title and description, buyer RUC, awarded supplier RUC, department, category (goods/services/works), procedure type, publication-date window and last-modified date. Newest first, pages of up to 50. Served by Croma (`as_of` says how current the data is), covering procedures published from 2020.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en el título y la descripción del proceso (opcional)."},"buyer_ruc":{"type":"string","pattern":"^(?:\\d{11})?$","default":"","description":"RUC de 11 dígitos (opcional)."},"supplier_ruc":{"type":"string","pattern":"^(?:\\d{11})?$","default":"","description":"RUC de 11 dígitos (opcional)."},"department":{"type":"string","maxLength":60,"default":"","description":"Departamento de la entidad compradora, p. ej. `LIMA` (opcional)."},"category":{"type":"string","enum":["","goods","services","works"],"default":"","description":"Categoría principal: `goods`, `services` o `works` (opcional)."},"method":{"type":"string","maxLength":80,"default":"","description":"Tipo de procedimiento tal como lo nombra la fuente, p. ej. `Licitación Pública` (opcional)."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"updated_after":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"laptops","department":"LIMA","from_date":"2025-01-01"}},{"id":"oece-process","name":"OECE Process by OCID","method":"POST","path":"/pe/oece/process/v1","url":"https://api.croma.run/pe/oece/process/v1","docs_url":"https://docs.usecroma.com/guides/peru/oece","country":"Peru","source":"OECE Contrataciones Abiertas","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one Peruvian public-procurement procedure (SEACE, published by OECE) by its OCDS id and return the full record: buyer, estimated value, items with their stage, bidding documents, awards with suppliers, and contracts. `found: false` when there is no procedure with that id. Served by Croma (`as_of` says how current the data is), covering procedures published from 2020.","required":["ocid"],"request_schema":{"ocid":{"type":"string","pattern":"^ocds-dgv273-[a-z0-9]+(?:-\\d+)+$","description":"OCDS process id, e.g. `ocds-dgv273-seacev3-873200`."}},"example_request":{"ocid":"ocds-dgv273-seacev3-873200"}},{"id":"tribunal-constitucional-rulings-search","name":"Tribunal Constitucional Rulings Search","method":"POST","path":"/pe/tribunal-constitucional/rulings-search/v1","url":"https://api.croma.run/pe/tribunal-constitucional/rulings-search/v1","docs_url":"https://docs.usecroma.com/guides/peru/tribunal-constitucional","country":"Peru","source":"Tribunal Constitucional","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every resolution the Tribunal Constitucional del Perú has published since 1996: sentencias, autos and sentencias interlocutorias. Free text matches the case file number, the resolution number and the full text. Filter by `type`, `proceeding_type` (`AA` amparo, `HC` hábeas corpus, `HD` hábeas data, `AC` cumplimiento, `AI`/`PI` inconstitucionalidad, `CC` competencial, `Q` queja), `chamber`, `registration_number` (the expediente), `year` and the publication date (`from_date`/`to_date`). Each result links to the document on the court's own site. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the case file number, the resolution number and the full text."},"type":{"type":"string","enum":["","sentencia","auto","sentencia_interlocutoria"],"default":"","description":"Optional kind of resolution: `sentencia`, `auto` (autos and decretos) or `sentencia_interlocutoria`."},"proceeding_type":{"type":"string","maxLength":40,"default":"","description":"Optional kind of proceeding, by code or by name: `AA` (amparo), `HC` (hábeas corpus), `HD` (hábeas data), `AC` (cumplimiento), `AI` or `PI` (inconstitucionalidad), `CC` (competencial), `Q` (queja)."},"chamber":{"type":"string","maxLength":20,"default":"","description":"Optional chamber: `Pleno`, `Sala Primera` or `Sala Segunda`."},"registration_number":{"type":"string","maxLength":40,"default":"","description":"Optional case file number (expediente) as the court writes it, e.g. `05005-2025-HC`. Returns every document of that case. Case and spaces are ignored."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year of publication. 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"debido proceso","proceeding_type":"HC"}},{"id":"tribunal-constitucional-ruling","name":"Tribunal Constitucional Ruling","method":"POST","path":"/pe/tribunal-constitucional/ruling/v1","url":"https://api.croma.run/pe/tribunal-constitucional/ruling/v1","docs_url":"https://docs.usecroma.com/guides/peru/tribunal-constitucional","country":"Peru","source":"Tribunal Constitucional","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one resolution of the Tribunal Constitucional del Perú by its `id` from a search result (e.g. `2026/05005-2025-HC.pdf`) or its `official_url`: its full text, the case file number, the kind of resolution and of proceeding, the chamber and the link to the document on the court's own site. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.","required":["ruling_id"],"request_schema":{"ruling_id":{"type":"string","minLength":5,"maxLength":400,"description":"The resolution's `id` from a search result, e.g. `2026/05005-2025-HC.pdf`. Its `official_url` works too."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"ruling_id":"2026/05005-2025-HC.pdf"}},{"id":"servir-tsc-resolutions-search","name":"Tribunal del Servicio Civil Resolutions Search","method":"POST","path":"/pe/servir-tsc/resolutions-search/v1","url":"https://api.croma.run/pe/servir-tsc/resolutions-search/v1","docs_url":"https://docs.usecroma.com/guides/peru/servir-tsc","country":"Peru","source":"Tribunal del Servicio Civil","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every resolution Peru's Tribunal del Servicio Civil (SERVIR) has issued since 2010, across both chambers. Free text matches the resolution number, the entity, the tribunal's summary and the full text. Filter by `chamber` (`primera_sala` or `segunda_sala`), `resolution_number`, `year` and the session date (`from_date`/`to_date`). Each result links to the document as published. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the resolution number, the entity, the summary and the full text."},"chamber":{"type":"string","maxLength":20,"default":"","description":"Optional chamber: `primera_sala` or `segunda_sala`."},"resolution_number":{"type":"string","maxLength":20,"default":"","description":"Optional resolution number, with or without its year, e.g. `05763-2025` or `5763`. Leading zeros are ignored."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year of the resolution. 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"régimen disciplinario","chamber":"primera_sala"}},{"id":"servir-tsc-resolution","name":"Tribunal del Servicio Civil Resolution","method":"POST","path":"/pe/servir-tsc/resolution/v1","url":"https://api.croma.run/pe/servir-tsc/resolution/v1","docs_url":"https://docs.usecroma.com/guides/peru/servir-tsc","country":"Peru","source":"Tribunal del Servicio Civil","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one resolution of Peru's Tribunal del Servicio Civil by its `id` from a search result (e.g. `7586381`) or its `page_url`: its full text, the number, the chamber, the session date, the entity, the case file, the employment regime, the subject and the tribunal's summary. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.","required":["resolution_id"],"request_schema":{"resolution_id":{"type":"string","minLength":1,"maxLength":300,"description":"The resolution's `id` from a search result, e.g. `7586381`. Its `page_url` works too."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"resolution_id":"7586381"}},{"id":"sunbiz-entities-search","name":"Sunbiz Entities Search","method":"POST","path":"/us/sunbiz/entities-search/v1","url":"https://api.croma.run/us/sunbiz/entities-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sunbiz","country":"United States","source":"Sunbiz (Florida Division of Corporations)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search Florida's registry of business entities (Sunbiz, the Division of Corporations) by free text over the entity name, its officers and its registered agent, by name prefix, status (active/inactive), filing type (LLC, corporation, partnership, trust...), city and state of the principal address, FEI number, formation-date window and last-published date. Pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en el nombre de la entidad, sus directivos y su agente registrado (opcional)."},"name_prefix":{"type":"string","maxLength":120,"default":"","description":"Inicio del nombre de la entidad, p. ej. `VIVA EXHIBITIONS` (opcional)."},"status":{"type":"string","enum":["","active","inactive"],"default":"","description":"Estado de la entidad: `active` o `inactive` (opcional)."},"filing_type":{"type":"string","enum":["","florida_llc","foreign_llc","domestic_profit","foreign_profit","domestic_nonprofit","foreign_nonprofit","domestic_limited_partnership","foreign_limited_partnership","nonprofit_registration","trust","registered_agent_designation"],"default":"","description":"Tipo de registro: `florida_llc`, `foreign_llc`, `domestic_profit`, `foreign_profit`, `domestic_nonprofit`, `foreign_nonprofit`, `domestic_limited_partnership`, `foreign_limited_partnership`, `nonprofit_registration`, `trust` o `registered_agent_designation` (opcional)."},"city":{"type":"string","maxLength":40,"default":"","description":"Ciudad de la dirección principal, p. ej. `MIAMI` (opcional)."},"state":{"type":"string","pattern":"^(?:[A-Z]{2})?$","default":"","description":"Código de estado de dos letras, p. ej. `FL` (opcional)."},"fei_number":{"type":"string","pattern":"^(?:\\d{2}-?\\d{7})?$","default":"","description":"FEI/EIN de nueve dígitos de la entidad (opcional)."},"filed_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"filed_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"updated_after":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"registered agents inc","status":"active","city":"MIAMI"}},{"id":"sunbiz-entity","name":"Sunbiz Entity by Document Number","method":"POST","path":"/us/sunbiz/entity/v1","url":"https://api.croma.run/us/sunbiz/entity/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sunbiz","country":"United States","source":"Sunbiz (Florida Division of Corporations)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one Florida business entity (Sunbiz, the Division of Corporations) by its document number and return the full record: status, filing type, addresses, formation date, FEI, annual reports, registered agent and officers. `found: false` when the registry has no entity with that number. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":["document_number"],"request_schema":{"document_number":{"type":"string","pattern":"^[A-Z]{0,2}\\d{4,12}$","description":"Número de documento de la entidad en Florida, p. ej. `P26000044030`."}},"example_request":{"document_number":"P26000044030"}},{"id":"sunbiz-fictitious-names-search","name":"Sunbiz Fictitious Names Search","method":"POST","path":"/us/sunbiz/fictitious-names-search/v1","url":"https://api.croma.run/us/sunbiz/fictitious-names-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sunbiz","country":"United States","source":"Sunbiz (Florida Division of Corporations)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every fictitious name (DBA) registered with the Florida Division of Corporations since 2008, in force or not, by the trade name and its owners' names, by status, county, the owning entity's document number, a company owner's FEI and filing dates. Answers who is behind a trade name. Newest first, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres del registro (opcional)."},"status":{"type":"string","enum":["","active","inactive"],"default":"","description":"Estado de la entidad: `active` o `inactive` (opcional)."},"county":{"type":"string","maxLength":100,"default":"","description":"Valor tal como lo escribe el registro (opcional)."},"owner_document_number":{"type":"string","pattern":"^(?:[A-Z]{0,2}\\d{4,12})?$","default":"","description":"Número de documento de una entidad de Florida, p. ej. `P26000044030` (opcional)."},"fei_number":{"type":"string","pattern":"^(?:\\d{2}-?\\d{7})?$","default":"","description":"FEI/EIN de nueve dígitos de la entidad (opcional)."},"filed_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"filed_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"tacos"}},{"id":"sunbiz-fictitious-name","name":"Sunbiz Fictitious Name","method":"POST","path":"/us/sunbiz/fictitious-name/v1","url":"https://api.croma.run/us/sunbiz/fictitious-name/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sunbiz","country":"United States","source":"Sunbiz (Florida Division of Corporations)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Read one Florida fictitious name (DBA) by its registration number, with its owners and every event filed against it since 1991: renewals, changes of address or owner, owners added or removed, cancellation. `found: false` when the Division has no such registration. Served by Croma, brought up to date daily.","required":["document_number"],"request_schema":{"document_number":{"type":"string","pattern":"^G\\d{10,11}$","description":"Número de registro del nombre comercial en Florida, p. ej. `G26000123456`."}},"example_request":{"document_number":"G26000132362"}},{"id":"sunbiz-federal-liens-search","name":"Sunbiz Federal Liens Search","method":"POST","path":"/us/sunbiz/federal-liens-search/v1","url":"https://api.croma.run/us/sunbiz/federal-liens-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sunbiz","country":"United States","source":"Sunbiz (Florida Division of Corporations)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the federal tax lien notices registered with the Florida Division of Corporations since 2009, and the releases since 1993, by the debtor's or the secured party's name, status (active, released, inactive) and filing dates. Each lien with its debtors, secured parties and events. Newest first, pages of up to 50. Served by Croma, brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres del registro (opcional)."},"status":{"type":"string","enum":["","active","released","inactive"],"default":"","description":"Estado del gravamen: `active`, `released` o `inactive` (opcional)."},"filed_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"filed_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"construction"}},{"id":"sunbiz-federal-lien","name":"Sunbiz Federal Lien","method":"POST","path":"/us/sunbiz/federal-lien/v1","url":"https://api.croma.run/us/sunbiz/federal-lien/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sunbiz","country":"United States","source":"Sunbiz (Florida Division of Corporations)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Read one federal tax lien registered with the Florida Division of Corporations by its document number: the notice, its debtors, its secured parties and every event, release included. `found: false` when the Division has no such lien. Served by Croma, brought up to date daily.","required":["document_number"],"request_schema":{"document_number":{"type":"string","pattern":"^\\d{2}FLR\\d{7}$","description":"Número de registro del gravamen federal en Florida, p. ej. `08FLR0012050`."}},"example_request":{"document_number":"26FLR0003440"}},{"id":"sunbiz-marks-search","name":"Sunbiz Marks Search","method":"POST","path":"/us/sunbiz/marks-search/v1","url":"https://api.croma.run/us/sunbiz/marks-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sunbiz","country":"United States","source":"Sunbiz (Florida Division of Corporations)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every trademark and service mark registered with the Florida Division of Corporations, in force or not, by the mark and its owners' names, status, class, the owning entity's document number and filing dates. Newest first, pages of up to 50. Served by Croma, brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres del registro (opcional)."},"status":{"type":"string","enum":["","active","inactive"],"default":"","description":"Estado de la entidad: `active` o `inactive` (opcional)."},"class_code":{"type":"string","maxLength":100,"default":"","description":"Valor tal como lo escribe el registro (opcional)."},"owner_document_number":{"type":"string","pattern":"^(?:[A-Z]{0,2}\\d{4,12})?$","default":"","description":"Número de documento de una entidad de Florida, p. ej. `P26000044030` (opcional)."},"filed_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"filed_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"coffee"}},{"id":"sunbiz-mark","name":"Sunbiz Mark","method":"POST","path":"/us/sunbiz/mark/v1","url":"https://api.croma.run/us/sunbiz/mark/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sunbiz","country":"United States","source":"Sunbiz (Florida Division of Corporations)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Read one trademark or service mark registered with the Florida Division of Corporations by its number: the mark, its classes, what it is used for, its dates and its owners. `found: false` when the Division has no such mark. Served by Croma, brought up to date daily.","required":["number"],"request_schema":{"number":{"type":"string","pattern":"^(?:T\\d{5}|T\\d{11}|\\d{6})$","description":"Número de registro de la marca en Florida, p. ej. `T26000123456`."}},"example_request":{"number":"T26000001070"}},{"id":"sunbiz-general-partnerships-search","name":"Sunbiz General Partnerships Search","method":"POST","path":"/us/sunbiz/general-partnerships-search/v1","url":"https://api.croma.run/us/sunbiz/general-partnerships-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sunbiz","country":"United States","source":"Sunbiz (Florida Division of Corporations)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every general and limited liability partnership registered with the Florida Division of Corporations by its name and its partners' names, status, a partner entity's document number and filing dates. Newest first, pages of up to 50. Served by Croma, brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres del registro (opcional)."},"status":{"type":"string","maxLength":100,"default":"","description":"Valor tal como lo escribe el registro (opcional)."},"partner_document_number":{"type":"string","pattern":"^(?:[A-Z]{0,2}\\d{4,12})?$","default":"","description":"Número de documento de una entidad de Florida, p. ej. `P26000044030` (opcional)."},"filed_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"filed_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"partners"}},{"id":"sunbiz-general-partnership","name":"Sunbiz General Partnership","method":"POST","path":"/us/sunbiz/general-partnership/v1","url":"https://api.croma.run/us/sunbiz/general-partnership/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sunbiz","country":"United States","source":"Sunbiz (Florida Division of Corporations)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Read one general or limited liability partnership registered with the Florida Division of Corporations by its document number, with its partners and every event filed against it. `found: false` when the Division has no such partnership. Served by Croma, brought up to date daily.","required":["document_number"],"request_schema":{"document_number":{"type":"string","pattern":"^(?:GP|LLP)\\d{6,10}$","description":"Número de documento de la sociedad general en Florida, p. ej. `GP2600012345`."}},"example_request":{"document_number":"GP2600000361"}},{"id":"sec-companies-search","name":"SEC EDGAR Companies Search","method":"POST","path":"/us/sec/companies-search/v1","url":"https://api.croma.run/us/sec/companies-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sec","country":"United States","source":"SEC EDGAR","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every filer EDGAR knows, about a million companies, funds, trusts and people, by current or former name, EIN, ticker, exchange, SIC code, state or country of incorporation, state of the business address and entity type. Returns each filer's CIK, EIN, SIC, state of incorporation, addresses, phone, tickers and former names. Most recently active first, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en el nombre actual y en los nombres anteriores del filer (opcional)."},"ein":{"type":"string","pattern":"^(?:\\d{2}-?\\d{7})?$","default":"","description":"FEI/EIN de nueve dígitos de la entidad (opcional)."},"ticker":{"type":"string","pattern":"^[A-Za-z0-9.\\-]{0,12}$","default":"","description":"Ticker bursátil, p. ej. `AAPL` (opcional)."},"exchange":{"type":"string","maxLength":20,"default":"","description":"Bolsa donde cotiza, como la nombra EDGAR: `NYSE`, `Nasdaq`, `OTC` o `CBOE` (opcional)."},"sic":{"type":"string","pattern":"^(?:\\d{3,4})?$","default":"","description":"Código SIC de la actividad, p. ej. `3571` (opcional)."},"state_of_incorporation":{"type":"string","pattern":"^(?:[A-Za-z][A-Za-z0-9])?$","default":"","description":"Código de estado o país de EDGAR, p. ej. `DE` o `E9` (opcional)."},"state":{"type":"string","pattern":"^(?:[A-Za-z][A-Za-z0-9])?$","default":"","description":"Código de estado o país de EDGAR, p. ej. `DE` o `E9` (opcional)."},"entity_type":{"type":"string","enum":["","operating","investment","other"],"default":"","description":"Tipo de filer en EDGAR: `operating`, `investment` u `other` (opcional)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"apple"}},{"id":"sec-company","name":"SEC EDGAR Company","method":"POST","path":"/us/sec/company/v1","url":"https://api.croma.run/us/sec/company/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sec","country":"United States","source":"SEC EDGAR","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one EDGAR filer by its CIK and return its record (name and former names, EIN, SIC code, state of incorporation, addresses, phone, tickers and exchanges, filing counts) with its latest event filings since 2020: 8-K current reports, mergers, delistings, registrations, late-filing notices and 13D stakes. `found: false` when EDGAR has no filer under that CIK. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":["cik"],"request_schema":{"cik":{"type":"string","pattern":"^\\d{1,10}$","description":"CIK del filer en EDGAR, con o sin ceros a la izquierda, p. ej. `320193`."}},"example_request":{"cik":"320193"}},{"id":"sec-filing-events-search","name":"SEC EDGAR Filing Events Search","method":"POST","path":"/us/sec/filing-events-search/v1","url":"https://api.croma.run/us/sec/filing-events-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sec","country":"United States","source":"SEC EDGAR","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every event filing on EDGAR since 2020: 8-K current reports with their items (bankruptcy, acquisition completed, delisting notice, officer change, ...), mergers and tender offers (S-4, F-4, 425, merger proxies), delistings and deregistrations (25-NSE, 15-12B), registrations and listings (S-1, F-1, 8-A), late-filing notices and Schedule 13D stakes. Filter by filer name, CIK, event type, form, 8-K item and filing dates; each event comes with the filer's EIN, state of incorporation and tickers. Newest first, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en el nombre actual y en los nombres anteriores del filer (opcional)."},"cik":{"type":"string","pattern":"^\\d{0,10}$","default":"","description":"CIK del emisor en EDGAR, con o sin ceros a la izquierda (opcional)."},"event_type":{"type":"string","enum":["","current_report","merger_or_acquisition","delisting_or_deregistration","registration","late_filing_notice","beneficial_ownership"],"default":"","description":"Tipo de evento: `current_report`, `merger_or_acquisition`, `delisting_or_deregistration`, `registration`, `late_filing_notice` o `beneficial_ownership` (opcional)."},"form":{"type":"string","maxLength":20,"default":"","description":"Tipo de formulario exactamente como lo escribe EDGAR, p. ej. `8-K`, `S-4`, `25-NSE`, `SC 13D` (opcional)."},"item":{"type":"string","pattern":"^(?:\\d\\.\\d{2})?$","default":"","description":"Ítem del 8-K, p. ej. `3.01` (aviso de exclusión de cotización) o `5.02` (cambio de directivos) (opcional)."},"filed_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"filed_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"form":"8-K","item":"3.01"}},{"id":"sec-filing-event","name":"SEC EDGAR Filing Event","method":"POST","path":"/us/sec/filing-event/v1","url":"https://api.croma.run/us/sec/filing-event/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sec","country":"United States","source":"SEC EDGAR","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one event filing by its EDGAR accession number and return it once per filer on it (a 13D's filer and the company it covers, a merger's two sides), each with the filer's EIN, state of incorporation and tickers. `found: false` when the accession number is not an event filing since 2020. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":["accession_number"],"request_schema":{"accession_number":{"type":"string","pattern":"^\\d{10}-\\d{2}-\\d{6}$","description":"Número de acceso de EDGAR del filing, p. ej. `0001587468-26-000001`."}},"example_request":{"accession_number":"0000929638-26-003569"}},{"id":"sec-form-d-search","name":"SEC Form D Search","method":"POST","path":"/us/sec/form-d-search/v1","url":"https://api.croma.run/us/sec/form-d-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sec","country":"United States","source":"SEC EDGAR","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every Form D filed with the SEC since 2008 (the notice a US company or fund files when it raises money privately) by free text over the issuer and its executives, directors and promoters, by issuer CIK, state, jurisdiction of incorporation, industry group, fund type, funds in or out, form type (new or amendment), filing-date window and minimum amount sold. Newest first, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en el nombre del emisor y en los nombres de sus directivos, directores y promotores (opcional)."},"issuer_cik":{"type":"string","pattern":"^\\d{0,10}$","default":"","description":"CIK del emisor en EDGAR, con o sin ceros a la izquierda (opcional)."},"state":{"type":"string","pattern":"^(?:[A-Z]{2})?$","default":"","description":"Código de estado de dos letras, p. ej. `FL` (opcional)."},"jurisdiction":{"type":"string","maxLength":40,"default":"","description":"Jurisdicción de constitución tal como la escribe el formulario, p. ej. `DELAWARE`, `CAYMAN ISLANDS` (opcional)."},"industry":{"type":"string","maxLength":60,"default":"","description":"Grupo de industria tal como lo nombra el formulario, p. ej. `Other Technology`, `Biotechnology`, `Pooled Investment Fund` (opcional)."},"fund_type":{"type":"string","enum":["","venture_capital_fund","private_equity_fund","hedge_fund","other_investment_fund"],"default":"","description":"Tipo de fondo, solo para emisores que son fondos: `venture_capital_fund`, `private_equity_fund`, `hedge_fund` u `other_investment_fund` (opcional)."},"funds":{"type":"string","enum":["include","exclude","only"],"default":"include","description":"Qué hacer con los fondos de inversión (pooled investment funds): `include` (por defecto), `exclude` para ver solo empresas operativas, `only` para ver solo fondos."},"form_type":{"type":"string","enum":["","D","D/A"],"default":"","description":"`D` para notificaciones nuevas, `D/A` para enmiendas (opcional)."},"filed_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"filed_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"min_amount_sold":{"type":"number","minimum":0,"default":0,"description":"Monto mínimo ya vendido, en dólares (opcional)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"databricks","funds":"exclude"}},{"id":"sec-form-d-filing","name":"SEC Form D Filing","method":"POST","path":"/us/sec/form-d-filing/v1","url":"https://api.croma.run/us/sec/form-d-filing/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sec","country":"United States","source":"SEC EDGAR","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one Form D filing by its EDGAR accession number and return the full record: issuer, executives and directors, industry, exemptions, securities, amounts offered and sold, investors, sales compensation and signature. `found: false` when EDGAR has no Form D under that number. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":["accession_number"],"request_schema":{"accession_number":{"type":"string","pattern":"^\\d{10}-\\d{2}-\\d{6}$","description":"Número de acceso de EDGAR del filing, p. ej. `0001587468-26-000001`."}},"example_request":{"accession_number":"0001587468-26-000001"}},{"id":"delaware-entities-search","name":"Delaware Entities Search","method":"POST","path":"/us/delaware/entities-search/v1","url":"https://api.croma.run/us/delaware/entities-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/delaware","country":"United States","source":"Delaware Division of Corporations","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search the Delaware Division of Corporations registry of business entities by name: corporations, LLCs, limited partnerships, statutory trusts and partnerships, domestic and foreign, active and inactive. Returns up to 50 matches with their file numbers (`truncated` says whether more exist); `exact: true` matches the full name exactly. Pass a file number to `delaware_entity` for the record.","required":["query"],"request_schema":{"query":{"type":"string","minLength":1,"maxLength":120,"description":"Nombre de la entidad a buscar, p. ej. `GOOGLE LLC`. Por palabras, sin distinguir mayúsculas."},"exact":{"type":"boolean","default":false,"description":"Si es `true`, solo entidades cuyo nombre es exactamente el buscado (opcional)."}},"example_request":{"query":"GOOGLE LLC","exact":true}},{"id":"delaware-entity","name":"Delaware Entity by File Number","method":"POST","path":"/us/delaware/entity/v1","url":"https://api.croma.run/us/delaware/entity/v1","docs_url":"https://docs.usecroma.com/guides/united-states/delaware","country":"United States","source":"Delaware Division of Corporations","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Look up one Delaware business entity by its file number and return the Division of Corporations' free record: name, incorporation or formation date, entity kind and type, residency, state of formation and the registered agent. `found: false` when the Division has no entity under that number. Live from the Division; not a statement of good standing.","required":["file_number"],"request_schema":{"file_number":{"type":"string","pattern":"^\\d{1,9}$","description":"Número de archivo (file number) de la entidad en Delaware, p. ej. `3582691`."}},"example_request":{"file_number":"3582691"}},{"id":"iapd-advisers-search","name":"SEC Form ADV Advisers Search","method":"POST","path":"/us/iapd/advisers-search/v1","url":"https://api.croma.run/us/iapd/advisers-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/iapd","country":"United States","source":"SEC Form ADV","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every investment adviser registered with the SEC or reporting to it as an exempt reporting adviser (most venture capital firms) by free text over its names, by firm type, state or country of the principal office, whether it manages private funds and minimum assets under management. By legal name, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"firm_type":{"type":"string","enum":["","registered","exempt_reporting"],"default":"","description":"Tipo de asesor: `registered` (registrado ante la SEC) o `exempt_reporting` (exempt reporting adviser, la mayoría de las firmas de venture capital) (opcional)."},"state":{"type":"string","pattern":"^(?:[A-Z]{2})?$","default":"","description":"Código de estado de dos letras, p. ej. `FL` (opcional)."},"country":{"type":"string","maxLength":60,"default":"","description":"País tal como lo escribe el formulario, p. ej. `United States`, `Cayman Islands` (opcional)."},"private_funds":{"type":"string","enum":["any","only","none"],"default":"any","description":"Qué hacer con los fondos privados: `any` (por defecto), `only` para ver solo asesores que administran fondos privados, `none` para ver solo los que no."},"min_aum":{"type":"number","minimum":0,"default":0,"description":"Monto mínimo en dólares (opcional)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"andreessen"}},{"id":"iapd-adviser","name":"SEC Form ADV Adviser","method":"POST","path":"/us/iapd/adviser/v1","url":"https://api.croma.run/us/iapd/adviser/v1","docs_url":"https://docs.usecroma.com/guides/united-states/iapd","country":"United States","source":"SEC Form ADV","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one investment adviser by its CRD number and return the full roster record plus the private funds it currently reports: total, gross asset value, a breakdown by fund type and the funds themselves, largest first. `found: false` when the SEC's roster has no adviser under that CRD. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":["crd"],"request_schema":{"crd":{"type":"string","pattern":"^\\d{1,10}$","description":"Número CRD del asesor, p. ej. `160489`."}},"example_request":{"crd":"160489"}},{"id":"iapd-private-funds-search","name":"SEC Form ADV Private Funds Search","method":"POST","path":"/us/iapd/private-funds-search/v1","url":"https://api.croma.run/us/iapd/private-funds-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/iapd","country":"United States","source":"SEC Form ADV","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every private fund reported to the SEC on Form ADV since 2011 (venture capital, private equity, hedge, real estate and other funds) by free text over the fund, its adviser and general partners, by adviser CRD, fund type, state or country of domicile, minimum gross asset value and filing-date window, current funds only or former ones too. Largest first, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date monthly.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"adviser_crd":{"type":"string","pattern":"^\\d{0,10}$","default":"","description":"Número CRD del asesor que administra el fondo (opcional)."},"fund_type":{"type":"string","enum":["","venture_capital","private_equity","hedge","real_estate","securitized_asset","liquidity","other"],"default":"","description":"Tipo de fondo privado: `venture_capital`, `private_equity`, `hedge`, `real_estate`, `securitized_asset`, `liquidity` u `other` (opcional)."},"state":{"type":"string","pattern":"^(?:[A-Z]{2})?$","default":"","description":"Código de estado de dos letras, p. ej. `FL` (opcional)."},"country":{"type":"string","maxLength":60,"default":"","description":"País tal como lo escribe el formulario, p. ej. `United States`, `Cayman Islands` (opcional)."},"min_gross_asset_value":{"type":"number","minimum":0,"default":0,"description":"Monto mínimo en dólares (opcional)."},"include_former":{"type":"boolean","default":false,"description":"Incluir también los fondos que el asesor dejó de reportar (por defecto solo los vigentes)."},"reported_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"reported_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"fund_type":"venture_capital","min_gross_asset_value":1000000000}},{"id":"iapd-private-fund","name":"SEC Form ADV Private Fund","method":"POST","path":"/us/iapd/private-fund/v1","url":"https://api.croma.run/us/iapd/private-fund/v1","docs_url":"https://docs.usecroma.com/guides/united-states/iapd","country":"United States","source":"SEC Form ADV","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one private fund by its Form ADV fund id (`805-` and ten digits) and return the full record from the latest filing that reports it: adviser, type, domicile, gross asset value, minimum investment, investors, ownership, master/feeder links, auditor, general partners, Form D file numbers and whether the adviser still reports it. `found: false` when no filing carries that id. Served by Croma (`as_of` says how current the data is), brought up to date monthly.","required":["fund_id"],"request_schema":{"fund_id":{"type":"string","pattern":"^805-\\d{10}$","description":"Id del fondo privado, p. ej. `805-8573539182`."}},"example_request":{"fund_id":"805-8573539182"}},{"id":"sec-13f-filings-search","name":"SEC Form 13F Filings Search","method":"POST","path":"/us/sec-13f/filings-search/v1","url":"https://api.croma.run/us/sec-13f/filings-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sec-13f","country":"United States","source":"SEC Form 13F","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every Form 13F filed with the SEC since 2013 (the quarterly report of what an institutional manager holds in US public equities) by free text over the manager's name, by manager CIK or CRD, state, the quarter reported and the minimum total value of the positions. Newest quarter first, pages of up to 50. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"manager_cik":{"type":"string","pattern":"^\\d{0,10}$","default":"","description":"CIK del emisor en EDGAR, con o sin ceros a la izquierda (opcional)."},"manager_crd":{"type":"string","pattern":"^\\d{0,10}$","default":"","description":"Número CRD del asesor que administra el fondo (opcional)."},"state":{"type":"string","pattern":"^(?:[A-Z]{2})?$","default":"","description":"Código de estado de dos letras, p. ej. `FL` (opcional)."},"period_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"period_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"min_value":{"type":"number","minimum":0,"default":0,"description":"Monto mínimo en dólares (opcional)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"berkshire hathaway"}},{"id":"sec-13f-filing","name":"SEC Form 13F Filing","method":"POST","path":"/us/sec-13f/filing/v1","url":"https://api.croma.run/us/sec-13f/filing/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sec-13f","country":"United States","source":"SEC Form 13F","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one Form 13F by its EDGAR accession number and return the filing with its positions, largest first: the manager, the quarter, the totals, and each position's issuer, CUSIP, value, shares, options and voting authority. `found: false` when no Form 13F carries that number. Served by Croma (`as_of` says how current the data is).","required":["accession_number"],"request_schema":{"accession_number":{"type":"string","pattern":"^\\d{10}-\\d{2}-\\d{6}$","description":"Número de acceso de EDGAR del filing, p. ej. `0001587468-26-000001`."}},"example_request":{"accession_number":"0001193125-26-226661"}},{"id":"sec-13f-holdings-search","name":"SEC Form 13F Holdings Search","method":"POST","path":"/us/sec-13f/holdings-search/v1","url":"https://api.croma.run/us/sec-13f/holdings-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sec-13f","country":"United States","source":"SEC Form 13F","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the positions institutional managers reported on Form 13F by free text over the issuer and the manager, by CUSIP, manager CIK or CRD, options only, the quarter reported and a minimum position value. Largest first, pages of up to 50. Answers both who holds one security and what one manager holds. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"cusip":{"type":"string","pattern":"^(?:[A-Za-z0-9]{9})?$","default":"","description":"CUSIP del valor, nueve caracteres, p. ej. `037833100` (opcional)."},"manager_cik":{"type":"string","pattern":"^\\d{0,10}$","default":"","description":"CIK del emisor en EDGAR, con o sin ceros a la izquierda (opcional)."},"manager_crd":{"type":"string","pattern":"^\\d{0,10}$","default":"","description":"Número CRD del asesor que administra el fondo (opcional)."},"put_call":{"type":"string","enum":["","PUT","CALL"],"default":"","description":"`PUT` o `CALL` para ver solo posiciones en opciones; vacío incluye todas (opcional)."},"period_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"period_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"min_value":{"type":"number","minimum":0,"default":0,"description":"Monto mínimo en dólares (opcional)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"nvidia","min_value":1000000000}},{"id":"dol-oflc-lca-search","name":"DOL H-1B LCA Search","method":"POST","path":"/us/dol-oflc/lca-search/v1","url":"https://api.croma.run/us/dol-oflc/lca-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/dol-oflc","country":"United States","source":"DOL H-1B and PERM","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every Labor Condition Application DOL decided since fiscal year 2008 (the filing an employer makes to hire on an H-1B, H-1B1 or E-3 visa) by employer, trade name or job title, employer FEIN, case number, fiscal year, visa class, case status, SOC code, worksite state, minimum offered wage and decision dates. Each determination carries the employer, the job, the offered and prevailing wage, the primary worksite, the employer's contact, the attorney and Appendix A. Newest decision first, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date as DOL publishes each quarter.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en el empleador, su nombre comercial y el cargo (opcional)."},"employer_fein":{"type":"string","pattern":"^(?:\\d{2}-?\\d{7})?$","default":"","description":"FEI/EIN de nueve dígitos de la entidad (opcional)."},"case_number":{"type":"string","pattern":"^(?:[A-Z]-(?:\\d{3}-)?\\d{5}-\\d{6,7})?$","default":"","description":"Número de caso de DOL (opcional)."},"fiscal_year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Año fiscal federal (octubre a septiembre), p. ej. `2026` (opcional)."},"visa_class":{"type":"string","enum":["","H-1B","H-1B1 Chile","H-1B1 Singapore","E-3 Australian"],"default":"","description":"Clase de visa: `H-1B`, `H-1B1 Chile`, `H-1B1 Singapore` o `E-3 Australian` (opcional)."},"case_status":{"type":"string","enum":["","Certified","Certified - Withdrawn","Withdrawn","Denied","Rejected","Invalidated"],"default":"","description":"Estado del caso: `Certified`, `Certified - Withdrawn`, `Withdrawn`, `Denied`, `Rejected` o `Invalidated` (opcional)."},"soc_code":{"type":"string","pattern":"^(?:\\d{2}-\\d{4}(?:\\.\\d{2})?)?$","default":"","description":"Código SOC de la ocupación, p. ej. `15-1252.00` (opcional)."},"worksite_state":{"type":"string","pattern":"^(?:[A-Z]{2})?$","default":"","description":"Código de estado de dos letras, p. ej. `FL` (opcional)."},"min_wage":{"type":"number","minimum":0,"default":0,"description":"Monto mínimo, en dólares (opcional)."},"decided_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"decided_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"software engineer","worksite_state":"CA","case_status":"Certified"}},{"id":"dol-oflc-lca-case","name":"DOL H-1B LCA Case","method":"POST","path":"/us/dol-oflc/lca-case/v1","url":"https://api.croma.run/us/dol-oflc/lca-case/v1","docs_url":"https://docs.usecroma.com/guides/united-states/dol-oflc","country":"United States","source":"DOL H-1B and PERM","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one Labor Condition Application by its DOL case number: every determination of it (a certification later withdrawn is decided again in a later fiscal year), newest first, with every worksite of the newest. `found: false` when DOL has published no determination under that number since fiscal year 2008. Served by Croma (`as_of` says how current the data is), brought up to date as DOL publishes each quarter.","required":["case_number"],"request_schema":{"case_number":{"type":"string","pattern":"^I-(?:\\d{3}-)?\\d{5}-\\d{6,7}$","description":"Número de caso LCA de DOL, p. ej. `I-200-25267-332158`."}},"example_request":{"case_number":"I-200-25267-332158"}},{"id":"dol-oflc-lca-worksites-search","name":"DOL H-1B LCA Worksites Search","method":"POST","path":"/us/dol-oflc/lca-worksites-search/v1","url":"https://api.croma.run/us/dol-oflc/lca-worksites-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/dol-oflc","country":"United States","source":"DOL H-1B and PERM","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every worksite of every Labor Condition Application since fiscal year 2008 by city, state, ZIP code, employer FEIN, case number and fiscal year: where H-1B workers are placed, by whom, and at what wage. Newest fiscal year first, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date as DOL publishes each quarter.","required":[],"request_schema":{"employer_fein":{"type":"string","pattern":"^(?:\\d{2}-?\\d{7})?$","default":"","description":"FEI/EIN de nueve dígitos de la entidad (opcional)."},"case_number":{"type":"string","pattern":"^(?:[A-Z]-(?:\\d{3}-)?\\d{5}-\\d{6,7})?$","default":"","description":"Número de caso de DOL (opcional)."},"fiscal_year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Año fiscal federal (octubre a septiembre), p. ej. `2026` (opcional)."},"state":{"type":"string","pattern":"^(?:[A-Z]{2})?$","default":"","description":"Código de estado de dos letras, p. ej. `FL` (opcional)."},"city":{"type":"string","maxLength":80,"default":"","description":"Ciudad del lugar de trabajo, p. ej. `Austin` (opcional)."},"postal_code":{"type":"string","pattern":"^(?:\\d{5})?$","default":"","description":"Código postal de cinco dígitos del lugar de trabajo (opcional)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"city":"Austin","state":"TX"}},{"id":"dol-oflc-perm-search","name":"DOL PERM Search","method":"POST","path":"/us/dol-oflc/perm-search/v1","url":"https://api.croma.run/us/dol-oflc/perm-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/dol-oflc","country":"United States","source":"DOL H-1B and PERM","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every PERM labor certification DOL decided since fiscal year 2008 (the filing an employer makes to sponsor a foreign worker for a green card), on both the form used until 2023 and the revised one, by employer, trade name, job title or law firm, employer FEIN, case number, fiscal year, case status, SOC code, worksite state, the worker's country of citizenship, minimum offered wage and decision dates. Each determination carries the employer, the job, the offered and prevailing wage, the worksite, the attorney, the worker (on the form used until 2023) and every other answer on the form. Newest decision first, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date as DOL publishes each quarter.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en el empleador, su nombre comercial, el cargo y el bufete (opcional)."},"employer_fein":{"type":"string","pattern":"^(?:\\d{2}-?\\d{7})?$","default":"","description":"FEI/EIN de nueve dígitos de la entidad (opcional)."},"case_number":{"type":"string","pattern":"^(?:[A-Z]-(?:\\d{3}-)?\\d{5}-\\d{5,6})?$","default":"","description":"Número de caso PERM de DOL (opcional)."},"fiscal_year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Año fiscal federal (octubre a septiembre), p. ej. `2026` (opcional)."},"case_status":{"type":"string","enum":["","Certified","Certified - Expired","Withdrawn","Denied"],"default":"","description":"Estado del caso: `Certified`, `Certified - Expired`, `Withdrawn` o `Denied` (opcional)."},"soc_code":{"type":"string","pattern":"^(?:\\d{2}-\\d{4}(?:\\.\\d{2})?)?$","default":"","description":"Código SOC de la ocupación, p. ej. `15-1252.00` (opcional)."},"worksite_state":{"type":"string","pattern":"^(?:[A-Z]{2})?$","default":"","description":"Código de estado de dos letras, p. ej. `FL` (opcional)."},"country_of_citizenship":{"type":"string","pattern":"^[A-Za-z .,'()-]{0,60}$","default":"","description":"País de ciudadanía del trabajador, en inglés, p. ej. `INDIA` (opcional)."},"min_wage":{"type":"number","minimum":0,"default":0,"description":"Monto mínimo, en dólares (opcional)."},"decided_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"decided_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"software engineer","worksite_state":"WA","case_status":"Certified"}},{"id":"dol-oflc-perm-case","name":"DOL PERM Case","method":"POST","path":"/us/dol-oflc/perm-case/v1","url":"https://api.croma.run/us/dol-oflc/perm-case/v1","docs_url":"https://docs.usecroma.com/guides/united-states/dol-oflc","country":"United States","source":"DOL H-1B and PERM","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one PERM labor certification by its DOL case number, on either form: every determination of it, newest fiscal year first. `found: false` when DOL has published no determination under that number since fiscal year 2008. Served by Croma (`as_of` says how current the data is), brought up to date as DOL publishes each quarter.","required":["case_number"],"request_schema":{"case_number":{"type":"string","pattern":"^[A-Z]-(?:\\d{3}-)?\\d{5}-\\d{5,6}$","description":"Número de caso PERM de DOL, p. ej. `G-100-25273-349207` o `A-23043-00641`."}},"example_request":{"case_number":"G-100-25273-349207"}},{"id":"sec-offerings-crowdfunding-search","name":"SEC Crowdfunding Search","method":"POST","path":"/us/sec-offerings/crowdfunding-search/v1","url":"https://api.croma.run/us/sec-offerings/crowdfunding-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sec-offerings","country":"United States","source":"SEC Crowdfunding and Reg A","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every Regulation Crowdfunding filing since 2016 (Form C offerings, amendments, progress updates, annual reports, terminations and withdrawals) by free text over the issuer, its co-issuers, its funding portal and its signers, by issuer CIK, offering file number, form type, state, funding portal, most recent revenue, target amount and filing dates. Each filing carries the offering's terms and two years of the issuer's financials. Newest first, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date as the SEC publishes each quarter.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en el nombre actual y en los nombres anteriores del filer (opcional)."},"issuer_cik":{"type":"string","pattern":"^\\d{0,10}$","default":"","description":"CIK del emisor en EDGAR, con o sin ceros a la izquierda (opcional)."},"file_number":{"type":"string","pattern":"^(?:[0-9A-Za-z]{2,3}-\\d{3,6})?$","default":"","description":"Número de expediente en la SEC, p. ej. `020-25453` o `024-12642` (opcional)."},"form_type":{"type":"string","maxLength":12,"default":"","description":"Tipo de formulario como lo escribe EDGAR, p. ej. `C`, `C/A`, `C-U`, `C-AR`, `1-A`, `1-A POS`, `1-K` (opcional)."},"state":{"type":"string","pattern":"^(?:[A-Za-z][A-Za-z0-9])?$","default":"","description":"Código de estado o país de EDGAR, p. ej. `DE` o `E9` (opcional)."},"intermediary_cik":{"type":"string","pattern":"^\\d{0,10}$","default":"","description":"CIK del emisor en EDGAR, con o sin ceros a la izquierda (opcional)."},"min_revenue":{"type":"number","minimum":0,"default":0,"description":"Monto mínimo, en dólares (opcional)."},"min_target_amount":{"type":"number","minimum":0,"default":0,"description":"Monto mínimo, en dólares (opcional)."},"filed_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"filed_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"coffee","form_type":"C"}},{"id":"sec-offerings-crowdfunding-filing","name":"SEC Crowdfunding Filing","method":"POST","path":"/us/sec-offerings/crowdfunding-filing/v1","url":"https://api.croma.run/us/sec-offerings/crowdfunding-filing/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sec-offerings","country":"United States","source":"SEC Crowdfunding and Reg A","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one Regulation Crowdfunding filing by its EDGAR accession number and return it in full: issuer, co-issuers, funding portal, offering terms, two years of financials, jurisdictions and signers. `found: false` when there is none under that number. Served by Croma (`as_of` says how current the data is), brought up to date as the SEC publishes each quarter.","required":["accession_number"],"request_schema":{"accession_number":{"type":"string","pattern":"^\\d{10}-\\d{2}-\\d{6}$","description":"Número de acceso de EDGAR del filing, p. ej. `0001587468-26-000001`."}},"example_request":{"accession_number":"0001779469-26-000002"}},{"id":"sec-offerings-crowdfunding-offering","name":"SEC Crowdfunding Offering","method":"POST","path":"/us/sec-offerings/crowdfunding-offering/v1","url":"https://api.croma.run/us/sec-offerings/crowdfunding-offering/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sec-offerings","country":"United States","source":"SEC Crowdfunding and Reg A","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Every filing of one Regulation Crowdfunding offering, by its SEC file number (`020-`), oldest first: the Form C, its amendments and progress updates, the issuer's annual reports and its termination. Follow one raise from launch to close. `found: false` when no filing carries the number. Served by Croma (`as_of` says how current the data is), brought up to date as the SEC publishes each quarter.","required":["file_number"],"request_schema":{"file_number":{"type":"string","pattern":"^020-\\d{5,6}$","description":"Número de expediente de la oferta de crowdfunding en la SEC, p. ej. `020-25453`."}},"example_request":{"file_number":"020-25453"}},{"id":"sec-offerings-reg-a-search","name":"SEC Regulation A Search","method":"POST","path":"/us/sec-offerings/reg-a-search/v1","url":"https://api.croma.run/us/sec-offerings/reg-a-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sec-offerings","country":"United States","source":"SEC Crowdfunding and Reg A","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every structured Regulation A filing since 2015 (offering statements 1-A, 1-A/A and 1-A POS, annual reports 1-K and exit reports 1-Z) by issuer name, issuer CIK, file number, form type, state, tier, minimum offering size and filing dates. Each offering statement carries the issuer's balance sheet and income statement and the offering's size, price and fees; each report, what its offerings sold and raised. Newest first, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date as the SEC publishes each quarter.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en el nombre actual y en los nombres anteriores del filer (opcional)."},"issuer_cik":{"type":"string","pattern":"^\\d{0,10}$","default":"","description":"CIK del emisor en EDGAR, con o sin ceros a la izquierda (opcional)."},"file_number":{"type":"string","pattern":"^(?:[0-9A-Za-z]{2,3}-\\d{3,6})?$","default":"","description":"Número de expediente en la SEC, p. ej. `020-25453` o `024-12642` (opcional)."},"form_type":{"type":"string","maxLength":12,"default":"","description":"Tipo de formulario como lo escribe EDGAR, p. ej. `C`, `C/A`, `C-U`, `C-AR`, `1-A`, `1-A POS`, `1-K` (opcional)."},"state":{"type":"string","pattern":"^(?:[A-Za-z][A-Za-z0-9])?$","default":"","description":"Código de estado o país de EDGAR, p. ej. `DE` o `E9` (opcional)."},"tier":{"type":"string","enum":["","Tier1","Tier2"],"default":"","description":"Nivel de la oferta de Regulation A: `Tier1` o `Tier2` (opcional)."},"min_total_offering":{"type":"number","minimum":0,"default":0,"description":"Monto mínimo, en dólares (opcional)."},"filed_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"filed_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"tier":"Tier2","form_type":"1-A"}},{"id":"sec-offerings-reg-a-filing","name":"SEC Regulation A Filing","method":"POST","path":"/us/sec-offerings/reg-a-filing/v1","url":"https://api.croma.run/us/sec-offerings/reg-a-filing/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sec-offerings","country":"United States","source":"SEC Crowdfunding and Reg A","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one Regulation A filing by its EDGAR accession number and return it in full: issuers, balance sheet and income statement, offering terms and fees, securities, jurisdictions, and for a report what each offering sold. `found: false` when there is none under that number. Served by Croma (`as_of` says how current the data is), brought up to date as the SEC publishes each quarter.","required":["accession_number"],"request_schema":{"accession_number":{"type":"string","pattern":"^\\d{10}-\\d{2}-\\d{6}$","description":"Número de acceso de EDGAR del filing, p. ej. `0001587468-26-000001`."}},"example_request":{"accession_number":"0001477932-26-004123"}},{"id":"sec-offerings-reg-a-offering","name":"SEC Regulation A Offering","method":"POST","path":"/us/sec-offerings/reg-a-offering/v1","url":"https://api.croma.run/us/sec-offerings/reg-a-offering/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sec-offerings","country":"United States","source":"SEC Crowdfunding and Reg A","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Every filing of one Regulation A offering, by its SEC file number (`024-`), oldest first: the offering statement, its amendments and post-qualification amendments, and every annual (1-K) or exit (1-Z) report that names it and says what it sold (every exit report names its offerings; about one annual report in five does). `found: false` when no filing carries the number. Served by Croma (`as_of` says how current the data is), brought up to date as the SEC publishes each quarter.","required":["file_number"],"request_schema":{"file_number":{"type":"string","pattern":"^024-\\d{5,6}$","description":"Número de expediente de la oferta de Regulation A en la SEC, p. ej. `024-12642`."}},"example_request":{"file_number":"024-12642"}},{"id":"ofac-sanctions-search","name":"OFAC Sanctions Search","method":"POST","path":"/us/ofac/sanctions-search/v1","url":"https://api.croma.run/us/ofac/sanctions-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/ofac","country":"United States","source":"OFAC Sanctions","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every party on the US Treasury's OFAC sanctions lists by free text over the primary name and every alias, by list, party type, sanctions program and country of an address. By name, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"list":{"type":"string","enum":["","sdn","non_sdn"],"default":"","description":"`sdn` para la lista de Specially Designated Nationals, `non_sdn` para la lista consolidada de los demás programas (opcional)."},"party_type":{"type":"string","enum":["","individual","entity","vessel","aircraft"],"default":"","description":"Tipo de parte: `individual`, `entity` (empresa u organización), `vessel` o `aircraft` (opcional)."},"program":{"type":"string","pattern":"^[A-Za-z0-9 ._/-]{0,40}$","default":"","description":"Código del programa de sanciones, p. ej. `RUSSIA-EO14024`, `SDGT`, `CUBA` (opcional)."},"country":{"type":"string","maxLength":60,"default":"","description":"País tal como lo escribe el formulario, p. ej. `United States`, `Cayman Islands` (opcional)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"aerocaribbean"}},{"id":"ofac-sanctions-screen","name":"OFAC Sanctions Screening","method":"POST","path":"/us/ofac/sanctions-screen/v1","url":"https://api.croma.run/us/ofac/sanctions-screen/v1","docs_url":"https://docs.usecroma.com/guides/united-states/ofac","country":"United States","source":"OFAC Sanctions","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Screen one person or company against the US Treasury's OFAC sanctions lists. Send a name, and optionally a date of birth, a country and an identity number; get back the parties that may be the same one, each with a 0 to 100 score and what decided it. Names match through typos, reordering, accents and transliterations, across primary names and aliases. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":["name"],"request_schema":{"name":{"type":"string","minLength":2,"maxLength":200,"description":"Nombre de la persona o empresa a verificar, en cualquier orden y con o sin tildes, p. ej. `Aero Caribbean Airlines`."},"birth_date":{"type":"string","pattern":"^(?:\\d{4}(?:-\\d{2}(?:-\\d{2})?)?)?$","default":"","description":"Fecha de nacimiento, `yyyy-mm-dd`, `yyyy-mm` o solo el año `yyyy` (opcional)."},"country":{"type":"string","maxLength":60,"default":"","description":"País de la persona o empresa: nombre en inglés o código ISO de dos letras, p. ej. `Cuba` o `CU` (opcional)."},"id_number":{"type":"string","maxLength":60,"default":"","description":"Número de pasaporte, documento de identidad, identificación tributaria o registro (opcional). Se compara sin espacios ni signos."},"party_type":{"type":"string","enum":["","individual","entity","vessel","aircraft"],"default":"","description":"Tipo de parte: `individual`, `entity` (empresa u organización), `vessel` o `aircraft` (opcional)."},"list":{"type":"string","enum":["","sdn","non_sdn"],"default":"","description":"`sdn` para la lista de Specially Designated Nationals, `non_sdn` para la lista consolidada de los demás programas (opcional)."},"threshold":{"type":"integer","minimum":50,"maximum":100,"default":85,"description":"Puntaje mínimo, de 50 a 100, para que un candidato cuente como posible coincidencia. Por defecto `85`."},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Máximo de coincidencias a devolver (1-50). Por defecto `10`."}},"example_request":{"name":"Aero Carribean Airlines","party_type":"entity","country":"Cuba"}},{"id":"ofac-sanctioned-party","name":"OFAC Sanctioned Party","method":"POST","path":"/us/ofac/sanctioned-party/v1","url":"https://api.croma.run/us/ofac/sanctioned-party/v1","docs_url":"https://docs.usecroma.com/guides/united-states/ofac","country":"United States","source":"OFAC Sanctions","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one sanctioned party by its id and return the full record: names and aliases, addresses, sanctions programs, vessel details and the identifiers OFAC records in its note. `found: false` when no list carries that id. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":["id"],"request_schema":{"id":{"type":"string","pattern":"^(?:sdn|non_sdn)-\\d{1,9}$","description":"Id de la parte sancionada, p. ej. `sdn-36`."}},"example_request":{"id":"sdn-36"}},{"id":"csl-parties-search","name":"Consolidated Screening List Search","method":"POST","path":"/us/csl/parties-search/v1","url":"https://api.croma.run/us/csl/parties-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/csl","country":"United States","source":"Consolidated Screening List","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Screen a name against every US export and sanctions screening list at once: OFAC's, the Entity List, the Denied Persons List and the other Commerce and State Department lists. Filter by name or alias, list, agency, program, country, identifying number or listing date. An identifying number (tax, registration, passport, SWIFT, digital currency address) matches ignoring spaces and punctuation. By name, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"list":{"type":"string","enum":["","sdn","ssi","plc","ns_mbs","cmic","cap","fse","el","dpl","uvl","meu","isn","dtc"],"default":"","description":"Lista: `sdn`, `ssi`, `plc`, `ns_mbs`, `cmic`, `cap`, `fse` (Tesoro, OFAC), `el`, `dpl`, `uvl`, `meu` (Comercio, BIS), `isn`, `dtc` (Departamento de Estado) (opcional)."},"agency":{"type":"string","enum":["","treasury","commerce","state"],"default":"","description":"Agencia que publica la lista: `treasury` (OFAC), `commerce` (Bureau of Industry and Security) o `state` (Departamento de Estado) (opcional)."},"party_type":{"type":"string","enum":["","individual","entity","vessel","aircraft"],"default":"","description":"Tipo de parte: `individual`, `entity` (empresa u organización), `vessel` o `aircraft` (opcional)."},"program":{"type":"string","pattern":"^[A-Za-zÀ-ÿ0-9 ._/()'’&,-]{0,120}$","default":"","description":"Programa de sanciones o ley tal como lo escribe la lista, p. ej. `SDGT`, `CMIC-EO13959` (opcional)."},"country":{"type":"string","pattern":"^(?:[A-Za-z]{2})?$","default":"","description":"Código de país de dos letras de alguna dirección de la parte, p. ej. `CN`, `VE` (opcional)."},"identifier":{"type":"string","maxLength":100,"default":"","description":"Número de identificación (tributario, de registro, pasaporte, SWIFT, dirección de criptomoneda…); se compara sin espacios ni signos (opcional)."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"huawei"}},{"id":"csl-party","name":"Consolidated Screening List Party","method":"POST","path":"/us/csl/party/v1","url":"https://api.croma.run/us/csl/party/v1","docs_url":"https://docs.usecroma.com/guides/united-states/csl","country":"United States","source":"Consolidated Screening List","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one party on the US export and sanctions screening lists by its id and return the full record: names and aliases, addresses, programs, identifying numbers, the Federal Register notice, the dates and license terms of the listing. `found: false` when no list carries that id. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":["id"],"request_schema":{"id":{"type":"string","pattern":"^(?:(?:sdn|ssi|plc|ns_mbs|cmic|cap|fse)-\\d{1,9}|(?:el|dpl|uvl|meu|isn|dtc)-[0-9a-f]{32,64})$","description":"Id de la parte en la Consolidated Screening List, p. ej. `sdn-36`, como lo devuelve la búsqueda."}},"example_request":{"id":"sdn-36"}},{"id":"sam-exclusions-search","name":"SAM.gov Exclusions Search","method":"POST","path":"/us/sam/exclusions-search/v1","url":"https://api.croma.run/us/sam/exclusions-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sam","country":"United States","source":"SAM.gov","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every party excluded from US federal contracts, grants and programs: people, firms, clinics, pharmacies and vessels excluded by HHS, OPM, DOJ, EPA and some fifty other agencies. Filter by name, classification, excluding agency, kind of exclusion, state, Unique Entity ID, CAGE code, NPI and the date the exclusion took effect. By name, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"classification":{"type":"string","enum":["","individual","firm","special_entity_designation","vessel"],"default":"","description":"Tipo de parte excluida: `individual`, `firm`, `special_entity_designation` o `vessel` (opcional)."},"agency":{"type":"string","pattern":"^[A-Za-z]{0,8}$","default":"","description":"Sigla de la agencia que excluyó, p. ej. `HHS`, `OPM`, `DOJ`, `EPA` (opcional)."},"exclusion_type":{"type":"string","enum":["","prohibition_restriction","ineligible_proceedings_completed","ineligible_proceedings_pending","voluntary_exclusion"],"default":"","description":"Tipo de exclusión: `prohibition_restriction`, `ineligible_proceedings_completed`, `ineligible_proceedings_pending` o `voluntary_exclusion` (opcional)."},"state":{"type":"string","maxLength":80,"default":"","description":"Estado o provincia de la dirección: el código de dos letras para un estado de EE. UU., p. ej. `FL` (opcional)."},"uei":{"type":"string","pattern":"^[A-Za-z0-9]{0,12}$","default":"","description":"Unique Entity ID de SAM.gov, p. ej. `HHB9E7U2YFM4` (opcional)."},"cage":{"type":"string","pattern":"^[A-Za-z0-9]{0,5}$","default":"","description":"Código CAGE, p. ej. `L0KT7` (opcional)."},"npi":{"type":"string","pattern":"^(?:\\d{10})?$","default":"","description":"National Provider Identifier de diez dígitos de un proveedor de salud (opcional)."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"pharmacy","agency":"HHS"}},{"id":"sam-exclusion","name":"SAM.gov Exclusion","method":"POST","path":"/us/sam/exclusion/v1","url":"https://api.croma.run/us/sam/exclusion/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sam","country":"United States","source":"SAM.gov","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one exclusion from US federal awards and programs by its SAM number and return the full record: the party, its identifiers, the excluding agency, the kind of exclusion, its dates and the agency's note. `found: false` when the list does not carry that id. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":["id"],"request_schema":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","description":"Número SAM de la exclusión, como lo devuelve la búsqueda."}},"example_request":{"id":"c11dcac9-e974-4e97-9350-077d697b8909"}},{"id":"sam-opportunities-search","name":"SAM.gov Contract Opportunities Search","method":"POST","path":"/us/sam/opportunities-search/v1","url":"https://api.croma.run/us/sam/opportunities-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sam-opportunities","country":"United States","source":"SAM.gov","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every contract opportunity US federal agencies list as active on SAM.gov: solicitations, combined synopsis/solicitations, presolicitations, sources sought, special notices, justifications and award notices, about 75,000. Filter by words in the title, text, awardee or solicitation number, kind of notice, solicitation number, department, agency, NAICS code, product service code, set-aside, state of the place of performance or of the contracting office, posting date and response deadline; order by posting date, deadline or award amount. Pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional words to find in the notice's title, description, awardee or solicitation number, e.g. `cybersecurity`, `janitorial services`. Every word must appear."},"type":{"type":"string","enum":["","solicitation","combined_synopsis_solicitation","presolicitation","sources_sought","special_notice","award_notice","justification","justification_and_approval","modification","sale_of_surplus_property","consolidate_bundle"],"default":"","description":"Optional kind of notice: `solicitation`, `combined_synopsis_solicitation`, `presolicitation`, `sources_sought`, `special_notice`, `award_notice`, `justification`, `justification_and_approval`, `modification`, `sale_of_surplus_property` or `consolidate_bundle`."},"solicitation_number":{"type":"string","pattern":"^[A-Za-z0-9._/ -]{0,80}$","default":"","description":"Optional solicitation number, exactly as the agency wrote it, e.g. `W912HN25B0012`. Case does not matter."},"department":{"type":"string","maxLength":120,"default":"","description":"Optional department or independent agency, exactly as SAM.gov writes it, e.g. `DEPT OF DEFENSE`, `VETERANS AFFAIRS, DEPARTMENT OF`, `GENERAL SERVICES ADMINISTRATION`. Case does not matter."},"sub_tier":{"type":"string","maxLength":120,"default":"","description":"Optional agency within the department, exactly as SAM.gov writes it, e.g. `DEPT OF THE ARMY`, `DEFENSE LOGISTICS AGENCY`, `FOREST SERVICE`. Case does not matter."},"naics_code":{"type":"string","pattern":"^(?:\\d{2,6})?$","default":"","description":"Optional NAICS code, two to six digits; a shorter code matches every code that starts with it, e.g. `23` for all of construction, `541512` for computer systems design."},"classification_code":{"type":"string","pattern":"^(?:[A-Za-z0-9]{1,4})?$","default":"","description":"Optional product service code (PSC), one to four characters; a shorter code matches every code that starts with it, e.g. `D` for IT services, `D302`, `7030`."},"set_aside":{"type":"string","pattern":"^[A-Za-z0-9]{0,12}$","default":"","description":"Optional set-aside code as SAM.gov writes it, e.g. `SBA` (total small business), `SBP` (partial), `SDVOSBC`, `WOSB`, `8A`, `HZC`, or `NONE` for notices that state no set-aside."},"performance_state":{"type":"string","pattern":"^(?:[A-Za-z]{2})?$","default":"","description":"Optional two-letter state of the place of performance, e.g. `VA`, `TX`."},"office_state":{"type":"string","pattern":"^(?:[A-Za-z]{2})?$","default":"","description":"Optional two-letter state of the contracting office, e.g. `PA`, `OH`."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"deadline_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"deadline_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"sort":{"type":"string","enum":["recent","deadline","amount_desc"],"default":"recent","description":"Order of the results: `recent` (newest posting first, the default), `deadline` (soonest response deadline first, notices with no deadline last) or `amount_desc` (largest award first)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"cybersecurity","type":"sources_sought"}},{"id":"sam-opportunity","name":"SAM.gov Contract Opportunity","method":"POST","path":"/us/sam/opportunity/v1","url":"https://api.croma.run/us/sam/opportunity/v1","docs_url":"https://docs.usecroma.com/guides/united-states/sam-opportunities","country":"United States","source":"SAM.gov","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one contract opportunity on SAM.gov by its notice id and return the full record: the notice's text, the solicitation number, the department, agency and office that posted it, the NAICS and product service codes, the set-aside, the response deadline, the place of performance, the contacts and, for an award, the contractor, the amount and the date. `found: false` when the active list does not carry that id. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":["id"],"request_schema":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$","description":"The notice's id in SAM.gov, 32 hex characters, as the search returns it."}},"example_request":{"id":"c3ade85bb7aa4603aee667173d4eb588"}},{"id":"fincen-msb-registrations-search","name":"FinCEN MSB Registrations Search","method":"POST","path":"/us/fincen/msb-registrations-search/v1","url":"https://api.croma.run/us/fincen/msb-registrations-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/fincen","country":"United States","source":"FinCEN MSB Registrations","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every money services business registered with FinCEN (money transmitters, check cashers, currency exchangers, prepaid access providers, in the US and abroad) by legal name or DBA, registered service, state, the states where it operates, country, whether it operates abroad and the date the filing was received, or its 14-digit MSB registration number; follow one business's filings by `registrant_key`. By legal name, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date weekly.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"activity":{"type":"string","enum":["","issuer_of_travelers_checks","seller_of_travelers_checks","redeemer_of_travelers_checks","issuer_of_money_orders","seller_of_money_orders","redeemer_of_money_orders","currency_dealer_or_exchanger","check_casher","money_transmitter","travelers_checks_sales_or_redemption","money_orders_sales_or_redemption","us_postal_service","seller_of_prepaid_access","provider_of_prepaid_access","dealer_in_foreign_exchange","other"],"default":"","description":"Actividad MSB declarada, p. ej. `money_transmitter`, `check_casher`, `dealer_in_foreign_exchange`, `seller_of_prepaid_access` (opcional)."},"state":{"type":"string","pattern":"^(?:[A-Za-z]{2})?$","default":"","description":"Código de dos letras de un estado o territorio de EE. UU., p. ej. `TX` (opcional)."},"operates_in":{"type":"string","pattern":"^(?:[A-Za-z]{2})?$","default":"","description":"Código de dos letras de un estado o territorio de EE. UU., p. ej. `TX` (opcional)."},"country":{"type":"string","maxLength":60,"default":"","description":"País de un registrante ubicado fuera de EE. UU., como lo escribe FinCEN, p. ej. `COLOMBIA`, `MEXICO`, `HONG KONG` (opcional)."},"operates_abroad":{"type":"boolean","default":false,"description":"`true` para ver solo los registros que declaran actividad fuera de EE. UU. (opcional)."},"registrant_key":{"type":"string","pattern":"^(?:[0-9a-f]{16})?$","default":"","description":"registrant_key de un registro, para ver todas las presentaciones del mismo negocio (opcional)."},"registration_number":{"type":"string","pattern":"^(?:\\d{14})?$","default":"","description":"Número de registro MSB de FinCEN, catorce dígitos (opcional)."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"remesas","activity":"money_transmitter"}},{"id":"fincen-msb-registration","name":"FinCEN MSB Registration","method":"POST","path":"/us/fincen/msb-registration/v1","url":"https://api.croma.run/us/fincen/msb-registration/v1","docs_url":"https://docs.usecroma.com/guides/united-states/fincen","country":"United States","source":"FinCEN MSB Registrations","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one money services business registration by its id and return the full record: names, address, registered services, the states where it operates, whether it operates abroad, branches and filing dates. `found: false` when the list does not carry that id. Served by Croma (`as_of` says how current the data is), brought up to date weekly.","required":["id"],"request_schema":{"id":{"type":"string","pattern":"^[0-9a-f]{16}(?:-\\d{1,2})?$","description":"Id del registro MSB, como lo devuelve la búsqueda."}},"example_request":{"id":"550f01d4ab63c95f"}},{"id":"uspto-trademarks-search","name":"USPTO Trademarks Search","method":"POST","path":"/us/uspto/trademarks-search/v1","url":"https://api.croma.run/us/uspto/trademarks-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/uspto","country":"United States","source":"United States Patent and Trademark Office","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search US federal trademark applications and registrations at the USPTO (every live mark and every mark filed since 2016) by any words of the mark, the owner's name or the goods and services, narrowed by `owner` (the full name), `status` (`live`, `dead`, `registered`, `pending`), `international_class` (Nice class 1-45), `owner_country`, `registration_number` and the filing date (`from_date`/`to_date`). Each result carries the mark, its status and dates, classes, goods and services, filing basis, owners, attorney and whether an assignment was recorded. Served by Croma from its copy of the register (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional words to find in the mark, the owner's name or the goods and services, e.g. `coffee`, `nintendo`. Every word must appear."},"owner":{"type":"string","maxLength":200,"default":"","description":"Optional owner's full name as the register records it, e.g. `Nintendo of America Inc.`. Case and punctuation do not matter, but the whole name must match; use `query` for part of a name."},"status":{"type":"string","enum":["","live","dead","registered","pending"],"default":"","description":"Optional status: `live` (a pending application or an active registration), `dead` (abandoned, cancelled or expired), `registered` (live and registered) or `pending` (live and not yet registered)."},"international_class":{"type":"string","pattern":"^(?:\\d{1,3}|[ABab])?$","default":"","description":"Optional international (Nice) class of the goods or services, 1 to 45, e.g. `9` (software, electronics), `25` (clothing), `35` (business services). `A`, `B` and `200` are the USPTO's classes for certification and collective membership marks."},"owner_country":{"type":"string","maxLength":60,"default":"","description":"Optional country of the owner's address as the register writes it, e.g. `UNITED STATES`, `COLOMBIA`, `JAPAN`, `REPUBLIC OF KOREA`."},"registration_number":{"type":"string","pattern":"^(?:\\d{1,8})?$","default":"","description":"Optional registration number the USPTO issued when the mark registered, e.g. `7726306`."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"nintendo","status":"registered","international_class":"9"}},{"id":"uspto-trademark","name":"USPTO Trademark","method":"POST","path":"/us/uspto/trademark/v1","url":"https://api.croma.run/us/uspto/trademark/v1","docs_url":"https://docs.usecroma.com/guides/united-states/uspto","country":"United States","source":"United States Patent and Trademark Office","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one US federal trademark application or registration by its eight-digit serial number, e.g. `79392077`: the mark, its status and dates, classes, goods and services, filing basis, owners, attorney and whether an assignment was recorded. Served by Croma from its copy of the register (`as_of` says how current the data is).","required":["serial_number"],"request_schema":{"serial_number":{"type":"string","pattern":"^\\d{8}$","description":"The mark's eight-digit serial number, assigned when the application was filed, e.g. `79392077`."}},"example_request":{"serial_number":"79392077"}},{"id":"gleif-entities-search","name":"GLEIF Entities Search","method":"POST","path":"/global/gleif/entities-search/v1","url":"https://api.croma.run/global/gleif/entities-search/v1","docs_url":"https://docs.usecroma.com/guides/global/gleif","country":"Global","source":"GLEIF (LEI)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every Legal Entity Identifier record in the world, about 3.4 million, by name (legal, trading, previous and transliterated names). Filter by legal-address country, legal jurisdiction (e.g. `US-DE`), business register and the number the entity is registered under there (a Delaware file number, a Sunbiz document number, a NIT), category and entity or registration status. By legal name, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date three times a day.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"country":{"type":"string","pattern":"^(?:[A-Za-z]{2})?$","default":"","description":"País de dos letras de la dirección legal, p. ej. `US`, `CO`, `KY` (opcional)."},"jurisdiction":{"type":"string","pattern":"^(?:[A-Za-z]{2}(?:-[A-Za-z0-9]{1,3})?)?$","default":"","description":"Jurisdicción legal: un país (`GB`) o una subdivisión (`US-DE`) (opcional)."},"registration_authority":{"type":"string","pattern":"^(?:RA\\d{6})?$","default":"","description":"Registro mercantil por su código GLEIF, p. ej. `RA000602` (Delaware) o `RA000603` (Florida) (opcional)."},"registered_as":{"type":"string","maxLength":100,"default":"","description":"Número de la entidad en su registro: un file number de Delaware, un document number de Sunbiz, un NIT (opcional)."},"category":{"type":"string","enum":["","GENERAL","FUND","BRANCH","SOLE_PROPRIETOR","RESIDENT_GOVERNMENT_ENTITY","INTERNATIONAL_ORGANIZATION"],"default":"","description":"Categoría de la entidad (opcional)."},"entity_status":{"type":"string","enum":["","ACTIVE","INACTIVE"],"default":"","description":"Estado de la entidad: `ACTIVE` o `INACTIVE` (opcional)."},"registration_status":{"type":"string","enum":["","ISSUED","LAPSED","RETIRED","DUPLICATE","ANNULLED","MERGED","PENDING_TRANSFER","PENDING_ARCHIVAL"],"default":"","description":"Estado del registro LEI, p. ej. `ISSUED` o `LAPSED` (opcional)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"bancolombia"}},{"id":"gleif-entity","name":"GLEIF Entity","method":"POST","path":"/global/gleif/entity/v1","url":"https://api.croma.run/global/gleif/entity/v1","docs_url":"https://docs.usecroma.com/guides/global/gleif","country":"Global","source":"GLEIF (LEI)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one Legal Entity Identifier and return the whole record with its ownership: the direct and ultimate parents that consolidate it, its fund manager, umbrella fund or head office, why it reports no parent when it does not, and up to 100 entities that report it as their parent. `found: false` when no record carries that LEI. Served by Croma (`as_of` says how current the data is), brought up to date three times a day.","required":["lei"],"request_schema":{"lei":{"type":"string","pattern":"^[A-Za-z0-9]{18}[0-9]{2}$","description":"LEI de 20 caracteres, p. ej. `5493001KJTIIGC8Y1R12`."}},"example_request":{"lei":"HWUPKR0MPOU8FGXBT394"}},{"id":"gleif-relationships-search","name":"GLEIF Relationships Search","method":"POST","path":"/global/gleif/relationships-search/v1","url":"https://api.croma.run/global/gleif/relationships-search/v1","docs_url":"https://docs.usecroma.com/guides/global/gleif","country":"Global","source":"GLEIF (LEI)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Page through the parent relationships reported to GLEIF by child, by parent or by type: every subsidiary, fund or branch that reports an entity as its parent, or every parent an entity reports. Current relationships only unless asked. By child LEI, pages of up to 50. Served by Croma, brought up to date three times a day.","required":[],"request_schema":{"child_lei":{"type":"string","pattern":"^(?:[A-Za-z0-9]{18}[0-9]{2})?$","default":"","description":"LEI de 20 caracteres (opcional)."},"parent_lei":{"type":"string","pattern":"^(?:[A-Za-z0-9]{18}[0-9]{2})?$","default":"","description":"LEI de 20 caracteres (opcional)."},"relationship_type":{"type":"string","enum":["","IS_DIRECTLY_CONSOLIDATED_BY","IS_ULTIMATELY_CONSOLIDATED_BY","IS_INTERNATIONAL_BRANCH_OF","IS_FUND-MANAGED_BY","IS_SUBFUND_OF","IS_FEEDER_TO"],"default":"","description":"Tipo de relación, p. ej. `IS_DIRECTLY_CONSOLIDATED_BY` (opcional)."},"include_inactive":{"type":"boolean","default":false,"description":"`true` para incluir también las relaciones que GLEIF retiró (opcional)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"parent_lei":"HWUPKR0MPOU8FGXBT394"}},{"id":"world-bank-indicators-search","name":"World Bank Indicators Search","method":"POST","path":"/global/world-bank/indicators-search/v1","url":"https://api.croma.run/global/world-bank/indicators-search/v1","docs_url":"https://docs.usecroma.com/guides/global/world-bank","country":"Global","source":"World Bank","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the World Bank's World Development Indicators catalog, about 1,500 indicators, by words in the name or definition and by `topic` (`poverty`, `education`, `health`, `social_protection_labor`, `financial_sector`, `economy`...). Each result carries the indicator code to pass to `world-bank-indicator-values`, its name, unit, topics, definition and the organization that produces the data. Served by Croma from its copy (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional words to find in the indicator's name or definition, e.g. `gini`, `unemployment youth`. Every word must appear."},"topic":{"type":"string","enum":["","agriculture","aid_effectiveness","climate_change","economy","education","energy_mining","environment","external_debt","financial_sector","gender","health","infrastructure","millennium_development_goals","poverty","private_sector","public_sector","science_technology","social_development","social_protection_labor","trade","urban_development"],"default":"","description":"Optional topic the World Bank files the indicator under, e.g. `poverty`, `education`, `social_protection_labor`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Results per page (1-200)."}},"example_request":{"query":"gini","topic":"poverty"}},{"id":"world-bank-indicator-values","name":"World Bank Indicator Values","method":"POST","path":"/global/world-bank/indicator-values/v1","url":"https://api.croma.run/global/world-bank/indicator-values/v1","docs_url":"https://docs.usecroma.com/guides/global/world-bank","country":"Global","source":"World Bank","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Read World Development Indicators values for the 42 economies of Latin America and the Caribbean, 1960 to the latest year, by `indicator_code` (e.g. `SI.POV.GINI`, `SL.UEM.TOTL.ZS`, `NY.GDP.PCAP.CD`; find codes with `world-bank-indicators-search`), `country_code` (ISO3, e.g. `COL`) and `year` or `year_from`/`year_to`. One row per country, indicator and year with a value, with its unit. Served by Croma from its copy (`as_of` says how current the data is).","required":[],"request_schema":{"indicator_code":{"type":"string","pattern":"^(?:[A-Za-z0-9][A-Za-z0-9_.]{1,59})?$","default":"","description":"Optional indicator code, as the indicators search returns it, e.g. `SI.POV.GINI` (Gini index), `SL.UEM.TOTL.ZS` (unemployment)."},"country_code":{"type":"string","pattern":"^(?:[A-Za-z]{3})?$","default":"","description":"Optional three-letter ISO 3166-1 country code, e.g. `COL`, `BRA`, `MEX`."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional single year, e.g. `2024`. 0 means every year."},"year_from":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional first year of a range, e.g. `2015`. 0 means no lower bound."},"year_to":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional last year of a range, e.g. `2024`. 0 means no upper bound."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Results per page (1-200)."}},"example_request":{"indicator_code":"SI.POV.GINI","country_code":"COL","year_from":2015}},{"id":"world-bank-poverty","name":"World Bank Poverty and Inequality","method":"POST","path":"/global/world-bank/poverty/v1","url":"https://api.croma.run/global/world-bank/poverty/v1","docs_url":"https://docs.usecroma.com/guides/global/world-bank","country":"Global","source":"World Bank","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Poverty and inequality estimates from the World Bank's Poverty and Inequality Platform, country by year: the share of people below $3.00, $4.20 and $8.30 a day (2021 PPP), the poverty gap at each line, the Gini index, mean and median welfare, deciles, and the household survey behind each estimate. Filter by `country_code` (ISO3), `year` or `year_from`/`year_to`, `reporting_level` (`national`, `urban`, `rural`) and `welfare_type` (`income`, `consumption`). Served by Croma from its copy (`as_of` says how current the data is).","required":[],"request_schema":{"country_code":{"type":"string","pattern":"^(?:[A-Za-z]{3})?$","default":"","description":"Optional three-letter ISO 3166-1 country code, e.g. `COL`, `BRA`, `MEX`."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional single year, e.g. `2024`. 0 means every year."},"year_from":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional first year of a range, e.g. `2015`. 0 means no lower bound."},"year_to":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional last year of a range, e.g. `2024`. 0 means no upper bound."},"reporting_level":{"type":"string","enum":["","national","urban","rural"],"default":"","description":"Optional coverage of the estimate: `national`, `urban` or `rural`. Some countries are covered by urban surveys only (Argentina), so leaving it empty returns every level."},"welfare_type":{"type":"string","enum":["","income","consumption"],"default":"","description":"Optional welfare measure the survey records: `income` (most of Latin America) or `consumption`."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Results per page (1-200)."}},"example_request":{"country_code":"COL","year_from":2015}},{"id":"ny-dos-corporations-search","name":"New York Corporations Search","method":"POST","path":"/us/ny-dos/corporations-search/v1","url":"https://api.croma.run/us/ny-dos/corporations-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/ny-dos","country":"United States","source":"New York Department of State","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every active entity on file with the New York Department of State (corporations, LLCs, partnerships, domestic and foreign) by name. Filter by entity type, county, jurisdiction of formation and first filing date. By name, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date weekly.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"entity_type":{"type":"string","maxLength":100,"default":"","description":"Valor tal como lo escribe el registro (opcional)."},"county":{"type":"string","maxLength":100,"default":"","description":"Valor tal como lo escribe el registro (opcional)."},"jurisdiction":{"type":"string","maxLength":100,"default":"","description":"Valor tal como lo escribe el registro (opcional)."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"acme holdings"}},{"id":"ny-dos-corporation","name":"New York Corporation","method":"POST","path":"/us/ny-dos/corporation/v1","url":"https://api.croma.run/us/ny-dos/corporation/v1","docs_url":"https://docs.usecroma.com/guides/united-states/ny-dos","country":"United States","source":"New York Department of State","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one active entity on file with the New York Department of State by its DOS ID and return the record with its parties: service of process, chief executive, registered agent and principal office. `found: false` when the list does not carry that DOS ID, which is also the answer for an entity that is no longer active. Served by Croma, brought up to date weekly.","required":["dos_id"],"request_schema":{"dos_id":{"type":"string","pattern":"^\\d{1,10}$","description":"DOS ID de la entidad en el registro del Departamento de Estado de Nueva York."}},"example_request":{"dos_id":"1560743"}},{"id":"colorado-sos-entities-search","name":"Colorado Business Entities Search","method":"POST","path":"/us/colorado-sos/entities-search/v1","url":"https://api.croma.run/us/colorado-sos/entities-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/colorado-sos","country":"United States","source":"Colorado Secretary of State","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every business entity on file with the Colorado Secretary of State since 1864, in any status, by name. Filter by status, entity type, jurisdiction of formation and formation date. By name, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"status":{"type":"string","maxLength":100,"default":"","description":"Valor tal como lo escribe el registro (opcional)."},"entity_type":{"type":"string","maxLength":100,"default":"","description":"Valor tal como lo escribe el registro (opcional)."},"jurisdiction":{"type":"string","maxLength":100,"default":"","description":"Valor tal como lo escribe el registro (opcional)."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"acme"}},{"id":"colorado-sos-entity","name":"Colorado Business Entity","method":"POST","path":"/us/colorado-sos/entity/v1","url":"https://api.croma.run/us/colorado-sos/entity/v1","docs_url":"https://docs.usecroma.com/guides/united-states/colorado-sos","country":"United States","source":"Colorado Secretary of State","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one business entity on file with the Colorado Secretary of State by its id and return the record: status, type, formation, addresses and registered agent. `found: false` when the register does not carry that id. Served by Croma, brought up to date daily.","required":["entity_id"],"request_schema":{"entity_id":{"type":"string","pattern":"^\\d{1,12}$","description":"ID de la entidad en el registro de la Secretaría de Estado de Colorado."}},"example_request":{"entity_id":"19871071914"}},{"id":"ct-sos-businesses-search","name":"Connecticut Businesses Search","method":"POST","path":"/us/ct-sos/businesses-search/v1","url":"https://api.croma.run/us/ct-sos/businesses-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/ct-sos","country":"United States","source":"Connecticut Secretary of the State","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every business on the Connecticut Secretary of the State's register, in any status, by name. Filter by status, business type, account number and registration date. By name, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date weekly.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"status":{"type":"string","maxLength":100,"default":"","description":"Valor tal como lo escribe el registro (opcional)."},"business_type":{"type":"string","maxLength":100,"default":"","description":"Valor tal como lo escribe el registro (opcional)."},"account_number":{"type":"string","pattern":"^\\d{0,10}$","default":"","description":"Número de cuenta de la empresa en Connecticut (opcional)."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"insurance"}},{"id":"ct-sos-business","name":"Connecticut Business","method":"POST","path":"/us/ct-sos/business/v1","url":"https://api.croma.run/us/ct-sos/business/v1","docs_url":"https://docs.usecroma.com/guides/united-states/ct-sos","country":"United States","source":"Connecticut Secretary of the State","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one business on the Connecticut register by its id and return the whole record with its principals (up to 200) and registered agents. `found: false` when the register does not carry that id. Served by Croma, brought up to date weekly.","required":["id"],"request_schema":{"id":{"type":"string","pattern":"^[A-Za-z0-9]{15}(?:[A-Za-z0-9]{3})?$","description":"Id del registro de la empresa en Connecticut, como lo devuelve la búsqueda."}},"example_request":{"id":"001t000000WmbJKAAZ"}},{"id":"ct-sos-principals-search","name":"Connecticut Principals Search","method":"POST","path":"/us/ct-sos/principals-search/v1","url":"https://api.croma.run/us/ct-sos/principals-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/ct-sos","country":"United States","source":"Connecticut Secretary of the State","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the principals (officers, directors, members, managers) every Connecticut business reports by the person's name, to find every business a person is part of, with each business's name and status. By name, pages of up to 50. Served by Croma, brought up to date weekly.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"john smith"}},{"id":"colorado-ucc-debtors-search","name":"Colorado UCC Debtors Search","method":"POST","path":"/us/colorado-ucc/debtors-search/v1","url":"https://api.croma.run/us/colorado-ucc/debtors-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/colorado-ucc","country":"United States","source":"Colorado Secretary of State (UCC)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the debtors every UCC and lien filing with the Colorado Secretary of State lists since 1966, companies and people, by name or by the organization's Colorado entity id, each with the filing that lists it and its lien's lapse date and whether it is still in force. By name, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"organization_id":{"type":"string","pattern":"^\\d{0,12}$","default":"","description":"ID de la entidad en el registro de la Secretaría de Estado de Colorado (opcional)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"parker bespoke furniture"}},{"id":"colorado-ucc-secured-parties-search","name":"Colorado UCC Secured Parties Search","method":"POST","path":"/us/colorado-ucc/secured-parties-search/v1","url":"https://api.croma.run/us/colorado-ucc/secured-parties-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/colorado-ucc","country":"United States","source":"Colorado Secretary of State (UCC)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the secured parties (lenders, lessors, lienholders) every UCC and lien filing with the Colorado Secretary of State lists since 1966 by name, each with the filing that lists it and its lien's lapse date and whether it is still in force. By name, pages of up to 50. Served by Croma, brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"jpmorgan chase"}},{"id":"colorado-ucc-lien","name":"Colorado UCC Lien","method":"POST","path":"/us/colorado-ucc/lien/v1","url":"https://api.croma.run/us/colorado-ucc/lien/v1","docs_url":"https://docs.usecroma.com/guides/united-states/colorado-ucc","country":"United States","source":"Colorado Secretary of State (UCC)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Read one UCC or lien filing with the Colorado Secretary of State by its number, or by the number of any of its amendments, and return the whole lien: every filing, every debtor and secured party, the collateral, the lapse date and whether it is still in force. `found: false` when no filing carries that number. Served by Croma, brought up to date daily.","required":["filing_number"],"request_schema":{"filing_number":{"type":"string","pattern":"^\\d{4}[0-9A-Za-z]\\d{6}$","description":"Número de registro UCC en Colorado: el del registro inicial o el de cualquier modificación."}},"example_request":{"filing_number":"20262077023"}},{"id":"ct-ucc-liens-search","name":"Connecticut UCC Liens Search","method":"POST","path":"/us/ct-ucc/liens-search/v1","url":"https://api.croma.run/us/ct-ucc/liens-search/v1","docs_url":"https://docs.usecroma.com/guides/united-states/ct-ucc","country":"United States","source":"Connecticut Secretary of the State (UCC)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the UCC and lien filings with the Connecticut Secretary of the State by the names of their debtors and secured parties, companies and people. Filter by status, lien type and filing date. Each lien comes with every filing, its parties, its lapse date and whether it is still in force. Newest first, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"status":{"type":"string","maxLength":100,"default":"","description":"Valor tal como lo escribe el registro (opcional)."},"lien_type":{"type":"string","maxLength":100,"default":"","description":"Valor tal como lo escribe el registro (opcional)."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"citizens bank"}},{"id":"ct-ucc-lien","name":"Connecticut UCC Lien","method":"POST","path":"/us/ct-ucc/lien/v1","url":"https://api.croma.run/us/ct-ucc/lien/v1","docs_url":"https://docs.usecroma.com/guides/united-states/ct-ucc","country":"United States","source":"Connecticut Secretary of the State (UCC)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Read one UCC or lien filing with the Connecticut Secretary of the State by its lien number or the number of any later filing, and return the whole lien: status, type, lapse date, every filing with the debtors and secured parties it lists, and whether it is still in force. `found: false` when the register does not carry that number. Served by Croma, brought up to date daily.","required":["filing_number"],"request_schema":{"filing_number":{"type":"string","pattern":"^[0-9A-Za-z]{1,10}$","description":"Número de registro UCC en Connecticut: el del gravamen o el de cualquier registro posterior."}},"example_request":{"filing_number":"0005046935"}},{"id":"djen-publications-search","name":"DJEN Publications Search","method":"POST","path":"/br/djen/publications-search/v1","url":"https://api.croma.run/br/djen/publications-search/v1","docs_url":"https://docs.usecroma.com/guides/brazil/djen","country":"Brazil","source":"Diário de Justiça Eletrônico Nacional (CNJ)","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Search Brazil's national court publications (Diário de Justiça Eletrônico Nacional, CNJ) by party name, lawyer name, OAB number, CNJ case number, court, free text and availability date: intimações, citações, editais and listas de distribuição from every state, federal, labour, electoral and military court and the superior courts, newest first, with the full text and the parties and lawyers each publication is addressed to. At least one of party, lawyer, OAB number, case number, court or text is required; `total` is exact for a single day and stops at 10,000 for a range.","required":[],"request_schema":{"party_name":{"type":"string","maxLength":200,"default":"","description":"Nombre de una parte tal como aparece en la publicación, p. ej. `BANCO DO BRASIL` (opcional). Coincide por palabras completas, sin distinguir mayúsculas ni acentos."},"lawyer_name":{"type":"string","maxLength":200,"default":"","description":"Nombre de un abogado destinatario de la publicación (opcional). Coincide por palabras completas, sin distinguir mayúsculas ni acentos."},"oab_number":{"type":"string","pattern":"^\\d{0,7}$","default":"","description":"Número de inscripción en la OAB de un abogado destinatario, solo dígitos, p. ej. `123456` (opcional)."},"oab_state":{"type":"string","pattern":"^(?:[A-Za-z]{2})?$","default":"","description":"Sigla del estado (UF) de la inscripción en la OAB, p. ej. `SP` (opcional)."},"registration_number":{"type":"string","pattern":"^(?:\\d{20}|\\d{7}-\\d{2}\\.\\d{4}\\.\\d\\.\\d{2}\\.\\d{4})?$","default":"","description":"Número único del proceso (CNJ): 20 dígitos o con el formato NNNNNNN-DD.AAAA.J.TR.OOOO, p. ej. `0001234-56.2026.8.26.0100` (opcional)."},"court_code":{"type":"string","default":"","description":"Sigla del tribunal en el DJEN, p. ej. `TJSP`, `TRT2`, `TRF1`, `STJ`, `TST`; los electorales llevan guion, `TRE-SP` (opcional). Sin distinguir mayúsculas."},"query":{"type":"string","maxLength":200,"default":"","description":"Texto a buscar en el cuerpo de la publicación (opcional)."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"medium":{"type":"string","enum":["any","diario","edital"],"default":"any","description":"`diario` para el Diário de Justiça Eletrônico Nacional, `edital` para la Plataforma Nacional de Editais, `any` para ambos."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":6,"maximum":50,"default":20,"description":"Resultados por página (6-50)."}},"example_request":{"party_name":"BANCO DO BRASIL","court_code":"TJSP","from_date":"2026-09-09","to_date":"2026-09-09","per_page":10}},{"id":"cgu-sanctions-search","name":"CGU Sanctions Search","method":"POST","path":"/br/cgu/sanctions-search/v1","url":"https://api.croma.run/br/cgu/sanctions-search/v1","docs_url":"https://docs.usecroma.com/guides/brazil/cgu","country":"Brazil","source":"Controladoria-Geral da União (CGU)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search Brazil's federal integrity registers kept by the Controladoria-Geral da União (CEIS, CNEP, CEAF, CEPIM and the leniency agreements) by free text over every name the register gives the party, by CNPJ or CPF (exact; CPFs come back masked), register, party type and the sanctioning body's state. One row per sanction, by name, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"document_number":{"type":"string","pattern":"^(?:\\d{11}|\\d{14}|\\d{3}\\.\\d{3}\\.\\d{3}-\\d{2}|\\d{2}\\.\\d{3}\\.\\d{3}\\/\\d{4}-\\d{2})?$","default":"","description":"CPF o CNPJ de la parte sancionada, con o sin puntuación, p. ej. `12.345.678/0001-90` (opcional). Coincidencia exacta."},"list":{"type":"string","enum":["","ceis","cnep","ceaf","cepim","leniency"],"default":"","description":"Registro: `ceis` (inidóneas y suspendidas), `cnep` (Ley Anticorrupción), `ceaf` (servidores federales expulsados), `cepim` (entidades sin fines de lucro impedidas), `leniency` (acuerdos de lenidad) (opcional)."},"party_type":{"type":"string","enum":["","individual","company"],"default":"","description":"Tipo de parte: `individual` (persona) o `company` (empresa u organización) (opcional)."},"sanctioning_body_state":{"type":"string","pattern":"^(?:[A-Za-z]{2})?$","default":"","description":"Sigla del estado (UF) del órgano que impuso la sanción, p. ej. `SP` (opcional). No es el estado de la parte."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"construtora","list":"ceis","per_page":10}},{"id":"cgu-sanction","name":"CGU Sanction","method":"POST","path":"/br/cgu/sanction/v1","url":"https://api.croma.run/br/cgu/sanction/v1","docs_url":"https://docs.usecroma.com/guides/brazil/cgu","country":"Brazil","source":"Controladoria-Geral da União (CGU)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Resolve one sanction on Brazil's federal integrity registers (CGU) by its id and return the full record: the party, its names and document (CPFs masked), the sanction, the sanctioning body, the dates, the legal basis, the process, and the fine, the expelled servant's post or the leniency agreement's terms where they apply. `found: false` when no register carries that id. Served by Croma (`as_of` says how current the data is), brought up to date daily.","required":["id"],"request_schema":{"id":{"type":"string","pattern":"^(?:ceis|cnep|ceaf|cepim|leniency)-[a-z0-9-]{1,80}$","description":"Id de la sanción, p. ej. `ceis-72529`, como lo devuelve la búsqueda."}},"example_request":{"id":"ceis-72529"}},{"id":"pgfn-debts-search","name":"PGFN Debts Search","method":"POST","path":"/br/pgfn/debts-search/v1","url":"https://api.croma.run/br/pgfn/debts-search/v1","docs_url":"https://docs.usecroma.com/guides/brazil/pgfn","country":"Brazil","source":"Procuradoria-Geral da Fazenda Nacional (PGFN)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the active debts Brazilian companies owe the Union in the dívida ativa (Procuradoria-Geral da Fazenda Nacional): federal taxes, social security contributions and the FGTS, by company name, CNPJ or its 8-character root, regime, state, status, the company's role in the debt, whether it is in court, and an amount range. Largest amount first, pages of up to 50. Companies only. Served by Croma (`as_of` says how current the data is), refreshed with each quarterly release.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"document_number":{"type":"string","pattern":"^(?:[A-Za-z0-9]{8}|[A-Za-z0-9]{12}\\d{2}|[A-Za-z0-9]{2}\\.[A-Za-z0-9]{3}\\.[A-Za-z0-9]{3}(?:\\/[A-Za-z0-9]{4}-\\d{2})?)?$","default":"","description":"CNPJ de la empresa deudora, con o sin puntuación, p. ej. `12.345.678/0001-90`, o su raíz de 8 caracteres para todos sus establecimientos (opcional)."},"regime":{"type":"string","enum":["","nao_previdenciario","previdenciario","fgts"],"default":"","description":"Tipo de deuda: `nao_previdenciario` (tributos y demás), `previdenciario` (contribuciones a la seguridad social) o `fgts` (opcional)."},"state":{"type":"string","pattern":"^(?:[A-Za-z]{2})?$","default":"","description":"Sigla del estado (UF) de la empresa deudora, p. ej. `SP` (opcional)."},"status_type":{"type":"string","enum":["","in_collection","tax_benefit","guaranteed","suspended_by_court","in_negotiation"],"default":"","description":"Situación: `in_collection` (en cobro), `tax_benefit` (beneficio fiscal), `guaranteed` (garantizada), `suspended_by_court` (suspendida por decisión judicial), `in_negotiation` (en negociación) (opcional)."},"debtor_type":{"type":"string","enum":["","principal","co_responsible","joint"],"default":"","description":"Papel de la empresa en la deuda: `principal`, `co_responsible` (corresponsable) o `joint` (solidaria) (opcional)."},"in_court":{"type":"string","enum":["any","yes","no"],"default":"any","description":"`yes` solo deudas en ejecución judicial, `no` solo las que no, `any` ambas."},"amount_min":{"type":"number","minimum":0,"default":0,"description":"Monto mínimo de la deuda en reales (opcional)."},"amount_max":{"type":"number","minimum":0,"default":0,"description":"Monto máximo de la deuda en reales; `0` sin límite (opcional)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"construtora","in_court":"yes","per_page":10}},{"id":"pgfn-debtor","name":"PGFN Debtor","method":"POST","path":"/br/pgfn/debtor/v1","url":"https://api.croma.run/br/pgfn/debtor/v1","docs_url":"https://docs.usecroma.com/guides/brazil/pgfn","country":"Brazil","source":"Procuradoria-Geral da Fazenda Nacional (PGFN)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Total what one Brazilian company owes the Union in the dívida ativa (Procuradoria-Geral da Fazenda Nacional), by CNPJ or by its 8-character root for every establishment: the number of debts, the amount owed as principal debtor, the part in court, a breakdown by regime (federal taxes, social security, FGTS), and the 50 largest debts. `found: false` when PGFN has inscribed nothing. Served by Croma (`as_of` says how current the data is), refreshed with each quarterly release.","required":["document_number"],"request_schema":{"document_number":{"type":"string","pattern":"^(?:[A-Za-z0-9]{8}|[A-Za-z0-9]{12}\\d{2}|[A-Za-z0-9]{2}\\.[A-Za-z0-9]{3}\\.[A-Za-z0-9]{3}(?:\\/[A-Za-z0-9]{4}-\\d{2})?)$","description":"CNPJ de la empresa, con o sin puntuación, p. ej. `12.345.678/0001-90`, o su raíz de 8 caracteres para sumar todos sus establecimientos."}},"example_request":{"document_number":"33.000.167/0001-01"}},{"id":"tst-labour-certificate","name":"TST Labour-Debt Certificate (CNDT)","method":"POST","path":"/br/tst/labour-certificate/v1","url":"https://api.croma.run/br/tst/labour-certificate/v1","docs_url":"https://docs.usecroma.com/guides/brazil/tst","country":"Brazil","source":"Tribunal Superior do Trabalho (TST)","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Issue Brazil's labour-debt certificate (Certidão Negativa de Débitos Trabalhistas) for a company by CNPJ, live from the Tribunal Superior do Trabalho: `clear`, `debts`, or `debts_secured` (every debt secured or suspended, with the legal effect of a clearance), the certificate number, issue time and validity, and each labour case with its court and whether the debt is secured. Optionally the official PDF. Async job; most calls finish inline.","required":["document_number"],"request_schema":{"document_number":{"type":"string","pattern":"^(?:[A-Za-z0-9]{12}\\d{2}|[A-Za-z0-9]{2}\\.[A-Za-z0-9]{3}\\.[A-Za-z0-9]{3}\\/[A-Za-z0-9]{4}-\\d{2})$","description":"CNPJ de la empresa, con o sin puntuación, p. ej. `33.000.167/0001-01`. Solo empresas: un CPF no se acepta."},"include_pdf":{"type":"boolean","default":false,"description":"Si es `true`, la respuesta incluye `pdf_url`, el enlace a la certidão oficial en PDF (opcional)."}},"example_request":{"document_number":"33.000.167/0001-01"}},{"id":"caixa-fgts-certificate","name":"Caixa FGTS Regularity Certificate (CRF)","method":"POST","path":"/br/caixa/fgts-certificate/v1","url":"https://api.croma.run/br/caixa/fgts-certificate/v1","docs_url":"https://docs.usecroma.com/guides/brazil/caixa","country":"Brazil","source":"Caixa Econômica Federal (FGTS)","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Check whether a Brazilian employer is up to date with the FGTS, by CNPJ, from Caixa Econômica Federal: `regular` with the current Certificado de Regularidade do FGTS (number, validity, establishment address), or `irregular` with which body reports the impediment (PGFN or Caixa). Optionally the certificates issued in the last 24 months. `found: false` when the CNPJ is not registered as an employer.","required":["document_number"],"request_schema":{"document_number":{"type":"string","pattern":"^(?:[A-Za-z0-9]{12}\\d{2}|[A-Za-z0-9]{2}\\.[A-Za-z0-9]{3}\\.[A-Za-z0-9]{3}\\/[A-Za-z0-9]{4}-\\d{2})$","description":"CNPJ de la empresa, con o sin puntuación, p. ej. `33.000.167/0001-01`. Solo empresas: un CPF no se acepta."},"include_history":{"type":"boolean","default":false,"description":"Si es `true`, la respuesta incluye `history`, los certificados emitidos en los últimos 24 meses (opcional)."}},"example_request":{"document_number":"33.000.167/0001-01"}},{"id":"mte-slave-labour-search","name":"MTE Slave Labour Register Search","method":"POST","path":"/br/mte/slave-labour-search/v1","url":"https://api.croma.run/br/mte/slave-labour-search/v1","docs_url":"https://docs.usecroma.com/guides/brazil/mte","country":"Brazil","source":"Ministério do Trabalho e Emprego (MTE)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search Brazil's register of employers caught keeping workers in conditions analogous to slavery (Cadastro de Empregadores, the \"Lista Suja\"), and the register of employers under a conduct-adjustment agreement, by CNPJ (or its 8-character root), CPF, name, state or inspection year. Each listing carries the establishment, workers found, activity, the final decision date and every period on the register. CPFs are matched exactly and returned masked. Updated daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"document_number":{"type":"string","pattern":"^(?:\\d{11}|\\d{3}\\.\\d{3}\\.\\d{3}-\\d{2}|[A-Za-z0-9]{8}|[A-Za-z0-9]{12}\\d{2}|[A-Za-z0-9]{2}\\.[A-Za-z0-9]{3}\\.[A-Za-z0-9]{3}(?:\\/[A-Za-z0-9]{4}-\\d{2})?)?$","default":"","description":"CPF o CNPJ del empleador, con o sin puntuación, p. ej. `12.345.678/0001-90`, o la raíz de 8 caracteres de un CNPJ para todos sus establecimientos (opcional). Coincidencia exacta."},"list":{"type":"string","enum":["","slave_labour","conduct_adjustment"],"default":"","description":"Registro: `slave_labour` (empleadores que sometieron trabajadores a condiciones análogas a la esclavitud) o `conduct_adjustment` (empleadores en ajuste de conducta) (opcional; por defecto ambos)."},"party_type":{"type":"string","enum":["","individual","company"],"default":"","description":"Tipo de parte: `individual` (persona) o `company` (empresa u organización) (opcional)."},"state":{"type":"string","pattern":"^(?:[A-Za-z]{2})?$","default":"","description":"Sigla del estado (UF) de la fiscalización, p. ej. `PA` (opcional)."},"inspection_year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Año de la fiscalización, p. ej. `2024`; `0` sin filtro (opcional)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"query":"fazenda"}},{"id":"mte-employer","name":"MTE Slave Labour Register Listing","method":"POST","path":"/br/mte/employer/v1","url":"https://api.croma.run/br/mte/employer/v1","docs_url":"https://docs.usecroma.com/guides/brazil/mte","country":"Brazil","source":"Ministério do Trabalho e Emprego (MTE)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"One listing from Brazil's slave labour employer registers, by the `id` the search returns. `found: false` once the employer has left the register.","required":["id"],"request_schema":{"id":{"type":"string","pattern":"^(?:slave_labour|conduct_adjustment)-[a-f0-9]{16}$","description":"Id del registro, p. ej. `slave_labour-3f9a0c12d4e5b6a7`, como lo devuelve la búsqueda."}},"example_request":{"id":"slave_labour-3f9a0c12d4e5b6a7"}},{"id":"ibama-embargoes-search","name":"IBAMA Environmental Embargoes Search","method":"POST","path":"/br/ibama/embargoes-search/v1","url":"https://api.croma.run/br/ibama/embargoes-search/v1","docs_url":"https://docs.usecroma.com/guides/brazil/ibama","country":"Brazil","source":"IBAMA (environmental embargoes)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every environmental embargo Brazil's federal environmental agency (IBAMA) has imposed since 1987, by CPF or CNPJ (or its 8-character root), name or property, state, municipality, term number or date. Each embargo carries its status (`active`, `lifted`, `cancelled`), the area in hectares, the place, the infraction and the process; the response counts how many matches are active. CPFs are matched exactly and returned masked. Updated daily.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Palabras a buscar en los nombres (opcional)."},"document_number":{"type":"string","pattern":"^(?:\\d{11}|\\d{3}\\.\\d{3}\\.\\d{3}-\\d{2}|[A-Za-z0-9]{8}|[A-Za-z0-9]{12}\\d{2}|[A-Za-z0-9]{2}\\.[A-Za-z0-9]{3}\\.[A-Za-z0-9]{3}(?:\\/[A-Za-z0-9]{4}-\\d{2})?)?$","default":"","description":"CPF o CNPJ de la persona o empresa embargada, con o sin puntuación, p. ej. `12.345.678/0001-90`, o la raíz de 8 caracteres de un CNPJ para todos sus establecimientos (opcional). Coincidencia exacta."},"status":{"type":"string","enum":["","active","lifted","cancelled"],"default":"","description":"Situación: `active` (embargo vigente), `lifted` (levantado) o `cancelled` (anulado) (opcional; por defecto todas)."},"state":{"type":"string","pattern":"^(?:[A-Za-z]{2})?$","default":"","description":"Sigla del estado (UF) del lugar embargado, p. ej. `PA` (opcional)."},"municipality_code":{"type":"string","pattern":"^(?:\\d{7})?$","default":"","description":"Código IBGE de 7 dígitos del municipio del lugar embargado, p. ej. `1500602` (opcional)."},"term_number":{"type":"string","maxLength":40,"default":"","description":"Número del término de embargo, tal como lo imprime IBAMA (opcional). Coincidencia exacta."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"state":"PA","status":"active","per_page":5}},{"id":"ibama-embargo","name":"IBAMA Environmental Embargo","method":"POST","path":"/br/ibama/embargo/v1","url":"https://api.croma.run/br/ibama/embargo/v1","docs_url":"https://docs.usecroma.com/guides/brazil/ibama","country":"Brazil","source":"IBAMA (environmental embargoes)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"One environmental embargo from IBAMA by the `id` the search returns: the party, the place and area, the infraction and whether it is active, lifted or cancelled.","required":["id"],"request_schema":{"id":{"type":"string","pattern":"^(?:\\d{1,10}|aie-[a-z0-9]{1,20})$","description":"Id del embargo, p. ej. `1234567`, como lo devuelve la búsqueda."}},"example_request":{"id":"1234567"}},{"id":"ibge-tables-search","name":"IBGE Statistical Tables Search","method":"POST","path":"/br/ibge/tables-search/v1","url":"https://api.croma.run/br/ibge/tables-search/v1","docs_url":"https://docs.usecroma.com/guides/brazil/ibge","country":"Brazil","source":"IBGE","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the catalog of Brazil's official statistics from IBGE: 9,000+ aggregate tables from PNAD Contínua, IPCA, PIB dos Municípios, Censo Demográfico and some 70 other surveys. Filter by words in the title, survey or variables, subject, periodicity or territorial level. Each table returns its periodicity, the periods it covers, the levels it has data for (country, region, state, municipality...), its variables with units and its classifications with their categories: everything `ibge-table-values` needs. Refreshed weekly.","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Words to find in the table's name, its survey, its subject or its variables, e.g. `desocupação` (optional)."},"survey":{"type":"string","maxLength":200,"default":"","description":"The survey, by the two-character `survey_id` a search result returns (e.g. `DD` for PNAD Contínua trimestral, `IA` for IPCA) or by its full name, e.g. `Censo Demográfico`; case and accents ignored (optional)."},"subject":{"type":"string","maxLength":200,"default":"","description":"The subject, as IBGE names it, e.g. `Trabalho` or `Índices de preços`; case and accents ignored (optional)."},"periodicity":{"type":"string","maxLength":40,"default":"","description":"How often the table is published: `monthly`, `quarterly`, `annual`, and the rarer periodicities a search result shows (optional)."},"territory_level":{"type":"string","enum":["","country","region","state","municipality"],"default":"","description":"Only tables with data at this level: `country`, `region`, `state` or `municipality` (optional)."},"table_id":{"type":"string","pattern":"^\\d{0,6}$","default":"","description":"One table by its number, e.g. `4099` (optional)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":20,"default":10,"description":"Tables per page (1-20)."}},"example_request":{"query":"taxa de desocupação","territory_level":"state","per_page":5}},{"id":"ibge-table-values","name":"IBGE Statistical Table Values","method":"POST","path":"/br/ibge/table-values/v1","url":"https://api.croma.run/br/ibge/table-values/v1","docs_url":"https://docs.usecroma.com/guides/brazil/ibge","country":"Brazil","source":"IBGE","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Read the values of one of IBGE's statistical tables for Brazil: unemployment (table 4099), IPCA inflation (7060), municipal GDP (5938), Censo 2022 population (4709) and 9,000+ more. Choose the variables, the period (`latest`, one period or a range), the territorial level (country, region, state, municipality) with optional IBGE territory codes, and classification categories. Each value comes with its territory, period, unit and categories. Up to 15,000 values per call.","required":["table_id"],"request_schema":{"table_id":{"type":"string","pattern":"^\\d{1,6}$","description":"The table's number, e.g. `4099` (unemployment, PNAD Contínua). `ibge-tables-search` finds it."},"variable_ids":{"type":"string","pattern":"^[\\d,\\s]*$","default":"","description":"The variables to return, by number and separated by commas, e.g. `4099` or `4099,4114`. Empty returns every variable of the table (optional)."},"period":{"type":"string","pattern":"^(latest|\\d{4}(\\d{2})?(-\\d{4}(\\d{2})?)?)$","default":"latest","description":"`latest` (the most recent period the table has), one period (`2023` for a year, `202609` for a month, `202602` for the second quarter of 2026), or a range of them, e.g. `202401-202604`."},"territory_level":{"type":"string","enum":["country","region","state","municipality"],"default":"country","description":"The territorial level of the values: `country` (Brazil), `region` (the five Grandes Regiões), `state` (the 27 UFs) or `municipality`."},"territory_code":{"type":"string","pattern":"^[\\d,\\s]*$","default":"","description":"IBGE codes of the territories, separated by commas: a region's 1 digit, a state's 2 (e.g. `35` São Paulo) or a municipality's 7 (e.g. `3550308` São Paulo). Empty returns every territory of the level (optional)."},"classifications":{"type":"string","pattern":"^[\\d,:;a-z\\s]*$","default":"","description":"Breakdowns to return, as `classification:categories`, several separated by `;`, e.g. `315:7170,7171` (two IPCA groups) or `2:all` (every category of classification 2). A classification left out returns its total (optional)."}},"example_request":{"table_id":"4099","variable_ids":"4099","period":"latest","territory_level":"country"}},{"id":"planalto-laws-search","name":"Planalto Laws Search","method":"POST","path":"/br/planalto/laws-search/v1","url":"https://api.croma.run/br/planalto/laws-search/v1","docs_url":"https://docs.usecroma.com/guides/brazil/planalto","country":"Brazil","source":"Presidência da República (Planalto)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search Brazil's federal legislation as the Presidência da República publishes it: the Constitution of 1988 and its amendments, and every lei complementar, lei ordinária, lei delegada, decreto-lei, decreto and medida provisória. Filter by `type`, a medida provisória's `measure_status`, exact `number` (with or without the thousands dot), signature `year` or a signature date range (`from_date`, `to_date`), and match free text against the act's name, its ementa and its full text. Results come most recently signed first, without the text; read one act with the Planalto Law endpoint. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Términos de búsqueda en el nombre, la ementa y el texto completo del acto (opcional)."},"type":{"type":"string","enum":["","constitution","constitutional_amendment","complementary_law","ordinary_law","delegated_law","decree_law","decree","provisional_measure"],"default":"","description":"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)."},"measure_status":{"type":"string","enum":["","pending","converted","lapsed","rejected","prejudiced","revoked"],"default":"","description":"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)."},"number":{"type":"string","pattern":"^(?:\\d[\\d.]{0,9}(?:\\s*-?\\s*[A-Za-z0-9]{1,3})?)?$","default":"","description":"Número del acto, con o sin punto de miles, p. ej. `13105` o `13.105` (opcional). Coincidencia exacta."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Año en que se firmó el acto, p. ej. `2015`; `0` sin filtro (opcional). Distingue actos que comparten número."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Resultados por página (1-50)."}},"example_request":{"type":"ordinary_law","number":"13105"}},{"id":"planalto-law","name":"Planalto Law","method":"POST","path":"/br/planalto/law/v1","url":"https://api.croma.run/br/planalto/law/v1","docs_url":"https://docs.usecroma.com/guides/brazil/planalto","country":"Brazil","source":"Presidência da República (Planalto)","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one Brazilian federal act by the `law_id` the search returns (`lei-13105-2015`, `cf-1988`): its current consolidated text, whole or one `article`, its ementa, signature and publication dates, whether it was revoked and by what, a medida provisória's standing and the law it became, the later acts that amended it article by article, and the earlier acts it amended in turn. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.","required":["law_id"],"request_schema":{"law_id":{"type":"string","pattern":"^(?:cf-\\d{4}|(?:lei|lcp|ldl|del|emc|ecr|mpv|dec)-[0-9a-z]+(?:-[0-9a-z]+)*-\\d{4})$","description":"Id del acto, p. ej. `lei-13105-2015` o `cf-1988`, como lo devuelve la búsqueda."},"article":{"type":"string","pattern":"^(?:\\d[\\d.]{0,6}\\s*[º°o]?\\s*(?:-?\\s*[A-Za-z]{1,2})?)?$","default":"","description":"Número de un artículo, p. ej. `12`, `1.029` u `8-A`, para devolver solo ese artículo (opcional)."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"law_id":"lei-13105-2015","article":"1.029"}},{"id":"corte-constitucional-rulings-search","name":"Corte Constitucional Rulings Search","method":"POST","path":"/co/corte-constitucional/rulings-search/v1","url":"https://api.croma.run/co/corte-constitucional/rulings-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/corte-constitucional","country":"Colombia","source":"Corte Constitucional","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every ruling the Corte Constitucional de Colombia has published since 1992: tutela (T), constitutionality (C) and unification (SU) judgments and autos (A). Free text matches the ruling's number, case file number, topics, synopsis, decision and full text. Filter by `type`, `year`, `registration_number` (the expediente), `reporting_judge` (the magistrado ponente) and the ruling date (`from_date`/`to_date`). Each result links to the ruling on the court's own site. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the ruling's number, case file number, topics, synopsis, decision and full text."},"type":{"type":"string","maxLength":40,"default":"","description":"Optional kind of ruling: `T` (tutela), `C` (constitucionalidad), `SU` (unificación) or `A` (auto). The Spanish names work too."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year of the ruling (the 2025 of T-013/25). 0 searches every year."},"registration_number":{"type":"string","maxLength":40,"default":"","description":"Optional case file number (expediente) as the court writes it: `T-10417884`, `D-15234`, `CJU-6063`. Case and spaces are ignored."},"reporting_judge":{"type":"string","maxLength":120,"default":"","description":"Optional magistrado ponente, by full name as it appears in `reporting_judges`. Case and accents are ignored."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"mínimo vital","type":"T"}},{"id":"corte-constitucional-ruling","name":"Corte Constitucional Ruling","method":"POST","path":"/co/corte-constitucional/ruling/v1","url":"https://api.croma.run/co/corte-constitucional/ruling/v1","docs_url":"https://docs.usecroma.com/guides/colombia/corte-constitucional","country":"Colombia","source":"Corte Constitucional","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one ruling of the Corte Constitucional de Colombia by its number (`T-013/25`, `SU.502/25`, `A. 006/25`) or its `relatoria_id`: its full text, what the court decided, the rights at stake, the magistrado ponente, the case file number and the link to the ruling on the court's own site. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.","required":["ruling_id"],"request_schema":{"ruling_id":{"type":"string","pattern":"^\\s*(?:[A-Za-z]{1,2}\\s*[.\\-]?\\s*\\d{1,4}\\s*[A-Za-z]?\\s*[/\\-]\\s*\\d{2}|\\d{1,9})\\s*$","description":"The ruling's number in any of the court's notations (`T-013/25`, `SU.502/25`, `A. 006/25`, `T-013-25`) or its `relatoria_id` (`47977`)."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"ruling_id":"T-013/25"}},{"id":"corte-suprema-rulings-search","name":"Corte Suprema Rulings Search","method":"POST","path":"/co/corte-suprema/rulings-search/v1","url":"https://api.croma.run/co/corte-suprema/rulings-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/corte-suprema","country":"Colombia","source":"Corte Suprema de Justicia","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every ruling the Corte Suprema de Justicia de Colombia has published since 1886, from every chamber, tutelas included. Free text matches the ruling's number, case file number, ponente, summary, topics and full text. Filter by `chamber` (civil, laboral, penal, plena and the historic chambers), `type` (SENTENCIA, AUTO...), `is_tutela`, `year`, `registration_number` (the radicado), `reporting_judge` (the magistrado ponente) and the ruling date (`from_date`/`to_date`). Each result links to the ruling's document at the court. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the ruling's number, case file number, ponente, summary, topics and full text."},"chamber":{"type":"string","maxLength":60,"default":"","description":"Optional chamber: `civil`, `laboral`, `penal`, `plena`, or the historic `constitucional` and `negocios-generales`."},"type":{"type":"string","maxLength":60,"default":"","description":"Optional kind of ruling as the court names it (`SENTENCIA`, `AUTO`, `AUTO INTERLOCUTORIO`), matched from the start of the name."},"is_tutela":{"type":["boolean","null"],"default":null,"description":"Optional: `true` for tutela decisions only, `false` for the chambers' own matters only. Omit it for both."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year of the ruling. 0 searches every year."},"registration_number":{"type":"string","maxLength":60,"default":"","description":"Optional case file number (radicado), with or without dashes: `11001-02-03-000-2026-04999-00`. Only the digits are compared."},"reporting_judge":{"type":"string","maxLength":120,"default":"","description":"Optional magistrado ponente, by full name as it appears in `reporting_judges`. Case and accents are ignored."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"prescripción adquisitiva","chamber":"civil"}},{"id":"corte-suprema-ruling","name":"Corte Suprema Ruling","method":"POST","path":"/co/corte-suprema/ruling/v1","url":"https://api.croma.run/co/corte-suprema/ruling/v1","docs_url":"https://docs.usecroma.com/guides/colombia/corte-suprema","country":"Colombia","source":"Corte Suprema de Justicia","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one ruling of the Corte Suprema de Justicia de Colombia by its `id` (`978662`) or its number (`AC6049-2026`): its chamber, kind, case file number, magistrado ponente, the relatoría's summary and topics, its full text, and the link to the ruling's document at the court. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false. Served by Croma (`as_of` says how current the data is).","required":["ruling_id"],"request_schema":{"ruling_id":{"type":"string","minLength":1,"maxLength":60,"pattern":"^\\s*[A-Za-z0-9][A-Za-z0-9 ./-]*\\s*$","description":"The ruling's `id` (`978662`) or its number as the court prints it (`AC6049-2026`)."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"ruling_id":"AC6049-2026"}},{"id":"creg-acts-search","name":"CREG Acts Search","method":"POST","path":"/co/creg/acts-search/v1","url":"https://api.croma.run/co/creg/acts-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/creg","country":"Colombia","source":"CREG","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every regulatory act of Colombia's energy and gas regulator, the Comisión de Regulación de Energía y Gas (CREG): resoluciones de carácter general and particular, circulares, conceptos jurídicos, proyectos de resolución and autos de inicio since 1994. Free text matches the title, the number and the full text. Filter by `kind`, `number`, `year` and the date of issue (`issued_from`/`issued_to`). Each result carries the CREG's notes on later amendments, Croma's copy of the act's files and links to the act on the CREG's own site. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the act's title, its number and its full text."},"kind":{"type":"string","enum":["any","resolution","particular_resolution","draft_resolution","circular","legal_opinion","order"],"default":"any","description":"Kind of act: `resolution` (resolución de carácter general), `particular_resolution` (about one company or one tariff), `draft_resolution` (proyecto under consultation), `circular`, `legal_opinion` (concepto jurídico), `order` (auto de inicio), or `any`."},"number":{"type":"string","maxLength":30,"default":"","description":"Optional act number, e.g. `101 128`, `131` or `345`. Leading zeros and the separator do not matter; combine it with `kind` or `year`."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year in the act's designation, 1994 or later. 0 searches every year."},"issued_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"issued_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"fronteras comerciales","kind":"resolution","year":2026}},{"id":"creg-act","name":"CREG Act","method":"POST","path":"/co/creg/act/v1","url":"https://api.croma.run/co/creg/act/v1","docs_url":"https://docs.usecroma.com/guides/colombia/creg","country":"Colombia","source":"CREG","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one regulatory act of Colombia's Comisión de Regulación de Energía y Gas (CREG) by its `id` from a search result (e.g. `resolucion_101-128_2026`) or its `official_url`: its full text, number, kind, dates, Diario Oficial reference, the CREG's notes on later amendments, Croma's copy of its files and the links to the act on the CREG's own site. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.","required":["act_id"],"request_schema":{"act_id":{"type":"string","minLength":1,"maxLength":300,"description":"The act's `id` from a search result, e.g. `resolucion_101-128_2026`. Its `official_url` works too."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"act_id":"resolucion_101-128_2026"}},{"id":"sic-normativa-regulations-search","name":"SIC Regulations Search","method":"POST","path":"/co/sic-normativa/regulations-search/v1","url":"https://api.croma.run/co/sic-normativa/regulations-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-normativa","country":"Colombia","source":"SIC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the normative register of Colombia's Superintendencia de Industria y Comercio (SIC): the laws and decrees it applies, its resoluciones, circulares, the títulos of the Circular Única, its doctrina, draft resolutions and appointments, about 7,600 acts. Free text matches the title and the Superintendencia's summary. Filter by `kind` (as the register files it: `Resoluciones`, `Circulares`, `Títulos Circular única`, `Leyes`, `Decretos`, `Doctrina`, ...), `topic` (its area, e.g. `Protección al Consumidor`), the date of issue and the date of publication. Each result carries Croma's copy of every attached file. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the title and the Superintendencia's summary."},"kind":{"type":"string","maxLength":60,"default":"","description":"Optional kind as the register files it, e.g. `Resoluciones`, `Circulares`, `Títulos Circular única`, `Leyes`, `Decretos`, `Doctrina`, `Nombramientos`. Case and accents are ignored."},"topic":{"type":"string","maxLength":80,"default":"","description":"Optional area of the Superintendencia, e.g. `Protección al Consumidor`, `Protección de Datos Personales`, `Propiedad Industrial`, matched from the start. Case and accents are ignored."},"issued_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"issued_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"published_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"published_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"habeas data","kind":"Circulares"}},{"id":"sic-normativa-regulation","name":"SIC Regulation","method":"POST","path":"/co/sic-normativa/regulation/v1","url":"https://api.croma.run/co/sic-normativa/regulation/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-normativa","country":"Colombia","source":"SIC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one act from the normative register of Colombia's Superintendencia de Industria y Comercio (SIC) by its `id` from a search result or its `official_url`: its kinds, area, dates, the Superintendencia's summary, Croma's copy of every attached file and the link to the act in the register.","required":["regulation_id"],"request_schema":{"regulation_id":{"type":"string","minLength":1,"maxLength":300,"description":"The act's `id` from a search result, e.g. `24968`. Its `official_url` works too."}},"example_request":{"regulation_id":"24968"}},{"id":"sic-normativa-bulletins-search","name":"SIC Legal Bulletin Search","method":"POST","path":"/co/sic-normativa/bulletins-search/v1","url":"https://api.croma.run/co/sic-normativa/bulletins-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-normativa","country":"Colombia","source":"SIC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the Boletín Jurídico of Colombia's Superintendencia de Industria y Comercio (SIC): the decisions and concepts its Oficina Asesora Jurídica highlights since 2019, by area (consumer protection, personal data, industrial property, competition, jurisdictional matters, technical regulations), plus the conceptos it publishes alongside. Free text matches the title, the summary and the tags. Filter by `section` (`bulletin` or `opinion`), `topic` and the date of publication. Each result carries the Superintendencia's summary and Croma's copy of the underlying document. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the title and the Superintendencia's summary."},"section":{"type":"string","enum":["any","bulletin","opinion"],"default":"any","description":"Section: `bulletin` (an item of the Boletín Jurídico), `opinion` (a concepto published alongside), or `any`."},"topic":{"type":"string","maxLength":80,"default":"","description":"Optional area of the Superintendencia, e.g. `Protección al Consumidor`, `Protección de Datos Personales`, `Propiedad Industrial`, matched from the start. Case and accents are ignored."},"published_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"published_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"retracto","topic":"Protección al Consumidor"}},{"id":"sic-normativa-bulletin","name":"SIC Legal Bulletin Item","method":"POST","path":"/co/sic-normativa/bulletin/v1","url":"https://api.croma.run/co/sic-normativa/bulletin/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-normativa","country":"Colombia","source":"SIC","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one item of the Boletín Jurídico of Colombia's Superintendencia de Industria y Comercio (SIC), or one of its conceptos, by its `id` from a search result or its `official_url`: its section, area, tags, date, the Superintendencia's summary, Croma's copy of the underlying document and the link to the item on its site.","required":["bulletin_id"],"request_schema":{"bulletin_id":{"type":"string","minLength":1,"maxLength":300,"description":"The item's `id` from a search result, e.g. `24896`. Its `official_url` works too."}},"example_request":{"bulletin_id":"24896"}},{"id":"sic-sanctions-sanctions-search","name":"SIC Sanctions Search","method":"POST","path":"/co/sic-sanctions/sanctions-search/v1","url":"https://api.croma.run/co/sic-sanctions/sanctions-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-sanctions","country":"Colombia","source":"SIC Sanctions","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every final (en firme) fine Colombia's Superintendencia de Industria y Comercio (SIC) has imposed through its consumer-protection investigations directorate since 2013: about 4,000 fines with the case, the resolution, the date, the party fined, the amount in pesos, the conduct and the sector. Free text matches the party, the conduct and the sector. Filter by `party` (the name, matched from the start), `sector`, `case_number`, `resolution_number` and the date of the resolution (`issued_from`/`issued_to`). Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional search terms matched against the party fined, the conduct and the sector."},"party":{"type":"string","maxLength":200,"default":"","description":"Optional name of the party fined, matched from the start. Case and accents are ignored."},"sector":{"type":"string","maxLength":120,"default":"","description":"Optional sector, e.g. `Servicios de financiación`, `Turismo`, `Comercio electrónico`, matched from the start. Case and accents are ignored."},"case_number":{"type":"string","maxLength":30,"default":"","description":"Optional case (radicado), e.g. `24 503714` or `24-503714`."},"resolution_number":{"type":"string","maxLength":20,"default":"","description":"Optional number of the resolution that imposed the fine, e.g. `40639`."},"issued_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"issued_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (1-100)."}},"example_request":{"query":"usura","sector":"Servicios de financiación"}},{"id":"sic-actos-acts-search","name":"SIC Acts Search","method":"POST","path":"/co/sic-actos/acts-search/v1","url":"https://api.croma.run/co/sic-actos/acts-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-actos","country":"Colombia","source":"SIC Acts","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every administrative act and judgment in the register of Colombia's Superintendencia de Industria y Comercio (SIC) since 2014: about 144,000 resoluciones of its investigations and 136,000 sentencias of its jurisdictional delegation. Free text matches the full text, the parties' names, the decisions and the office. Filter by `party_document_number` (a NIT or cédula of any party or representative), `case_number` (the radicado), `office`, `type` (`resolution`, `judgment`) and the date of the act (`issued_from`/`issued_to`). Each result carries the parties with their identification and Croma's copy of the act's document. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the full text, the parties' names, the decisions and the office."},"type":{"type":"string","enum":["any","resolution","judgment"],"default":"any","description":"Type of act: `resolution` (resolución) or `judgment` (sentencia), or `any`."},"office":{"type":"string","maxLength":160,"default":"","description":"Optional issuing office, e.g. `Grupo de Trabajo de Defensa del Consumidor`, matched from the start. Case and accents are ignored."},"case_number":{"type":"string","maxLength":30,"default":"","description":"Optional case (radicado), e.g. `24-449511` or `24 449511`."},"party_document_number":{"type":"string","maxLength":20,"default":"","description":"Optional identification number (NIT or cédula) of any party or representative, digits only; separators are ignored."},"issued_from":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"issued_to":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"habeas data","type":"resolution","issued_from":"2025-01-01"}},{"id":"sic-actos-act","name":"SIC Act","method":"POST","path":"/co/sic-actos/act/v1","url":"https://api.croma.run/co/sic-actos/act/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-actos","country":"Colombia","source":"SIC Acts","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one administrative act or judgment from the register of Colombia's Superintendencia de Industria y Comercio (SIC) by its `id` from a search result: its full text, number, date, office, case, decisions, parties with their identification and Croma's copy of its document. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.","required":["act_id"],"request_schema":{"act_id":{"type":"string","minLength":1,"maxLength":12,"description":"The act's `id` from a search result, e.g. `2681688`."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"act_id":"2681688"}},{"id":"sic-tramites-case","name":"SIC Filing","method":"POST","path":"/co/sic-tramites/case/v1","url":"https://api.croma.run/co/sic-tramites/case/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-tramites","country":"Colombia","source":"SIC Trámites","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Read one filing (radicado) at Colombia's Superintendencia de Industria y Comercio (SIC), the way one of its parties reads it: give the `year` and `case_number` of the radicado (plus `case_control` when it has one) and the `document_type` and `document_number` of one of its parties. Returns every action (consecutivo) with its procedure (trámite), event, action, direction, date and sender or addressee, plus the administrative acts (autos, sentencias, resoluciones) issued in the filing. With `include_documents` (the default) every document of every action and every act is returned with `document_url`, a stored byte-identical copy, and `source_document_url`; this can take a few minutes, so set `include_documents: false` when only the actions are needed. `document_type` defaults to `NIT`. `found: false` when the filing does not exist or the document is not one of its parties': the Superintendencia does not tell the two apart.","required":["year","case_number","document_number"],"request_schema":{"year":{"type":"integer","minimum":1990,"maximum":2100,"description":"Year of the filing (radicado), four digits, e.g. `2025`."},"case_number":{"type":"string","pattern":"^\\d{1,9}$","minLength":1,"maxLength":9,"description":"Number of the filing (número de radicado) without the year, e.g. `194793`."},"case_control":{"type":"string","pattern":"^[A-Za-z0-9]{0,2}$","maxLength":2,"default":"","description":"Optional control characters of the filing (control radicado), up to 2. Most filings have none."},"document_type":{"type":"string","enum":["CC","CE","NIT","PA","TI","RC","PEP","PPT"],"default":"NIT","description":"Colombian document type. Defaults to `NIT`."},"document_number":{"type":"string","minLength":3,"maxLength":30,"description":"Document number (alphanumeric with hyphens allowed)."},"include_documents":{"type":"boolean","default":true,"description":"When true (the default), every document of the filing is returned with a `document_url` to a stored copy. Set to `false` for the actions alone, which answers much faster."},"cache":{"type":"boolean","default":true,"description":"Set to `false` to skip any stored result for this lookup and read the source again. The fresh answer replaces the stored one and is charged as a new request. Default `true`."}},"example_request":{"year":2025,"case_number":"194793","document_type":"NIT","document_number":"1234567890","include_documents":false}},{"id":"sic-gazette-entries-search","name":"SIC Industrial Property Gazette Entries Search","method":"POST","path":"/co/sic-gazette/entries-search/v1","url":"https://api.croma.run/co/sic-gazette/entries-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-gazette","country":"Colombia","source":"SIC Industrial Property Gazette","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every entry of the Gaceta de la Propiedad Industrial of Colombia's Superintendencia de Industria y Comercio (SIC) since July 2016: trademark applications, collective marks, territorial extensions, slogans, registrations, cancellation decisions and rulings; invention patents, utility models, PCT national phases and layout designs; industrial designs. Free text matches the sign or title, the applicant, the owner, the agent and the file number. Filter by `file_number` (matched from the start), `domain`, `section`, `issue_number`, `status`, `nice_class` and the publication date (`from_date`/`to_date`). Each result carries the issue and section, the file number, the filing date, the sign or title, the Nice classes, the priorities, the status, the parties and the classification, with Croma's copy of the issue's workbook. Served by Croma from its copy of the gazette (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional words to find in the sign or the title, the applicant, the owner, the agent or the file number, e.g. `cafe`, `bavaria`. Every word must appear."},"file_number":{"type":"string","pattern":"^[A-Z0-9/]{0,20}$","default":"","description":"Optional file (expediente) number as the gazette prints it, matched from the start, e.g. `SD2026/0099552` for one file or `NC2026/` for every new-creation file of 2026."},"domain":{"type":"string","enum":["","trademarks","patents","designs"],"default":"","description":"Optional part of the gazette: `trademarks` (distinctive signs), `patents` (inventions, utility models and layout designs) or `designs` (industrial designs)."},"section":{"type":"string","pattern":"^[a-z_]{0,40}$","default":"","description":"Optional section: `trademarks`, `collective_marks`, `territorial_extensions`, `slogans`, `registrations`, `cancellation_decisions`, `nullity_judgments`, `patents`, `utility_models`, `pct_patents`, `layout_designs`, `industrial_designs` or `judgment_publications`."},"issue_number":{"type":"integer","minimum":0,"maximum":100000,"default":0,"description":"Optional issue number of the gazette, e.g. `1116`. 0 searches every issue."},"status":{"type":"string","maxLength":40,"default":"","description":"Optional status as the gazette prints it, e.g. `Publicada`, `Registrada`, `Publicada sin pago`, `Publicado`. Case and accents are ignored."},"nice_class":{"type":"integer","minimum":0,"maximum":45,"default":0,"description":"Optional international (Nice) class of the goods or services, 1 to 45, e.g. `25` (clothing). 0 searches every class."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"cafe","domain":"trademarks","section":"trademarks"}},{"id":"sic-gazette-issues-search","name":"SIC Industrial Property Gazette Issues","method":"POST","path":"/co/sic-gazette/issues-search/v1","url":"https://api.croma.run/co/sic-gazette/issues-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-gazette","country":"Colombia","source":"SIC Industrial Property Gazette","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"List the issues of the Gaceta de la Propiedad Industrial of Colombia's Superintendencia de Industria y Comercio (SIC) since July 2016, one row per issue and part (`trademarks`, `patents`, `designs`), newest first, filtered by part and publication date (`from_date`/`to_date`). Each carries its number, publication date, sections, entry count and Croma's copy of the workbook the Superintendencia published. Served by Croma from its copy of the gazette (`as_of` says how current the data is).","required":[],"request_schema":{"domain":{"type":"string","enum":["","trademarks","patents","designs"],"default":"","description":"Optional part of the gazette: `trademarks` (distinctive signs), `patents` (inventions, utility models and layout designs) or `designs` (industrial designs)."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"domain":"trademarks","from_date":"2026-01-01"}},{"id":"sic-gazette-issue","name":"SIC Industrial Property Gazette Issue","method":"POST","path":"/co/sic-gazette/issue/v1","url":"https://api.croma.run/co/sic-gazette/issue/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-gazette","country":"Colombia","source":"SIC Industrial Property Gazette","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one issue of the Gaceta de la Propiedad Industrial of Colombia's Superintendencia de Industria y Comercio (SIC) by its `number` and part (`domain`: `trademarks`, `patents` or `designs`): its publication date, sections, entry count, when the workbook was generated and Croma's copy of the workbook the Superintendencia published. Served by Croma from its copy of the gazette (`as_of` says how current the data is).","required":["number","domain"],"request_schema":{"number":{"type":"integer","minimum":1,"maximum":100000,"description":"The issue number of the gazette, e.g. `1116`."},"domain":{"type":"string","enum":["trademarks","patents","designs"],"description":"The part of the gazette: `trademarks` (distinctive signs), `patents` (inventions, utility models and layout designs) or `designs` (industrial designs)."}},"example_request":{"number":1116,"domain":"trademarks"}},{"id":"sic-ip-trademarks-search","name":"SIC Trademarks Search","method":"POST","path":"/co/sic-ip/trademarks-search/v1","url":"https://api.croma.run/co/sic-ip/trademarks-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-ip","country":"Colombia","source":"SIC, Registro de la Propiedad Industrial","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search Colombia's trademark register (SIC), about 0.9 million cases filed since 1930, by words of the sign or the owner's name, narrowed by `status` (as the register words it, e.g. `Registrada`), `nice_class` (1-45), `certificate_number` and the filing date (`from_date`/`to_date`). Each result carries the file number, certificate, sign, status, vigencia, owners, Nice classes, gazette and the label. Read one case in full with `sic_ip_trademark`. Served by Croma from its copy (`as_of` says how current it is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional words to find in the sign or in the owner's name, e.g. `credisander`, `bancolombia`. Every word must appear."},"status":{"type":"string","maxLength":80,"default":"","description":"Optional status exactly as the register words it, e.g. `Registrada`, `Publicada`, `Concedida`, `Negada`, `Caducado`, `Bajo Examen Formal`. Case and accents matter."},"nice_class":{"type":"string","pattern":"^(?:[1-9]|[1-3]\\d|4[0-5])?$","default":"","description":"Optional Nice class of the goods or services, 1 to 45, e.g. `36` (financial services), `25` (clothing)."},"certificate_number":{"type":"string","pattern":"^\\d{0,9}$","default":"","description":"Optional registration certificate number, e.g. `612592`."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"cafe","nice_class":"30"}},{"id":"sic-ip-patents-search","name":"SIC Patents Search","method":"POST","path":"/co/sic-ip/patents-search/v1","url":"https://api.croma.run/co/sic-ip/patents-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-ip","country":"Colombia","source":"SIC, Registro de la Propiedad Industrial","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search Colombia's patent register (SIC): inventions, utility models, PCT national phases and layout designs, by words of the title or the owner's name, narrowed by `status` and the filing date (`from_date`/`to_date`). Each result carries the file number, grant number, title, filing date, status, owners and the characteristic figure. Read one case in full with `sic_ip_patent`. Served by Croma from its copy (`as_of`).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional words to find in the title or in the owner's name, e.g. `licuadora`. Every word must appear."},"status":{"type":"string","maxLength":80,"default":"","description":"Optional status exactly as the register words it, e.g. `Registrada`, `Publicada`, `Concedida`, `Negada`, `Caducado`, `Bajo Examen Formal`. Case and accents matter."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"dispositivo","from_date":"2025-01-01"}},{"id":"sic-ip-designs-search","name":"SIC Industrial Designs Search","method":"POST","path":"/co/sic-ip/designs-search/v1","url":"https://api.croma.run/co/sic-ip/designs-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-ip","country":"Colombia","source":"SIC, Registro de la Propiedad Industrial","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search Colombia's industrial design register (SIC) by words of the title or the owner's name, narrowed by `status` and the filing date (`from_date`/`to_date`). Each result carries the file number, registration number, title, filing date, status, owners and the characteristic figure. Read one case in full with `sic_ip_design`. Served by Croma from its copy (`as_of`).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional words to find in the title or in the owner's name, e.g. `licuadora`. Every word must appear."},"status":{"type":"string","maxLength":80,"default":"","description":"Optional status exactly as the register words it, e.g. `Registrada`, `Publicada`, `Concedida`, `Negada`, `Caducado`, `Bajo Examen Formal`. Case and accents matter."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"botella"}},{"id":"sic-ip-resolutions-search","name":"SIC Industrial Property Resolutions Search","method":"POST","path":"/co/sic-ip/resolutions-search/v1","url":"https://api.croma.run/co/sic-ip/resolutions-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-ip","country":"Colombia","source":"SIC, Registro de la Propiedad Industrial","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every resolution and oficio Colombia's industrial-property office (SIC) has sent out since 2016 in trademark, patent and design cases (grants, refusals, oppositions, cancellations, transfers, licences, security interests, requirements) by words of the document type or the parties notified, narrowed by `file_number` (the case or the main case it belongs to), `kind` (`resolucion` or `oficio`) and the date it was sent (`from_date`/`to_date`). Each result carries the number, type, act date, the case numbers, the parties with their notification and ejecutoria dates and the PDF. Served by Croma from its copy (`as_of`).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional words to find in the document's type or in the names of the parties it was notified to, e.g. `cancelación`, `garantía mobiliaria`. Every word must appear."},"file_number":{"type":"string","pattern":"^\\s*(?:(?:[A-Za-z]{2}\\s*\\d{4}\\s*\\/?\\s*\\d{1,7}|\\d{1,10})\\s*)?$","default":"","description":"Optional file number (expediente) the document was issued in, either the request itself or the main case it belongs to, e.g. `SD2026/0083453`."},"kind":{"type":"string","enum":["","resolucion","oficio"],"default":"","description":"Optional kind of document: `resolucion` (a decision) or `oficio` (a requirement or a notice). Empty lists both."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"cancelación","kind":"resolucion"}},{"id":"sic-ip-trademark","name":"SIC Trademark","method":"POST","path":"/co/sic-ip/trademark/v1","url":"https://api.croma.run/co/sic-ip/trademark/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-ip","country":"Colombia","source":"SIC, Registro de la Propiedad Industrial","rate_limit":"100 requests / 24h","served_from":"lookup","monitorable":true,"description":"Read one Colombian trademark case in full by its file number (expediente, e.g. `SD2026/0066943`): status and dates, certificate and vigencia, the sign and its label, each Nice class with its goods and services, every party (owner, applicant, agent, contact) with identification number and address, the full procedural history, linked oppositions, transfers and other requests, and every document of the file with Croma's copy. Answers from Croma's copy within a day of the last read (`served_from`, `checked_at`); `found: false` when the register has no trademark under the number. Find numbers with `sic_ip_trademarks_search`.","required":["file_number"],"request_schema":{"file_number":{"type":"string","pattern":"^\\s*(?:[A-Za-z]{2}\\s*\\d{4}\\s*\\/?\\s*\\d{1,7}|\\d{1,10})\\s*$","description":"The case's file number (expediente), e.g. `SD2026/0031979` for a trademark or `NC2026/0006185` for a patent or a design, or the bare digits of a file opened before 2016 (`16137606`). The year's consecutive may be written without its leading zeros."}},"example_request":{"file_number":"SD2026/0066943"}},{"id":"sic-ip-patent","name":"SIC Patent","method":"POST","path":"/co/sic-ip/patent/v1","url":"https://api.croma.run/co/sic-ip/patent/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-ip","country":"Colombia","source":"SIC, Registro de la Propiedad Industrial","rate_limit":"100 requests / 24h","served_from":"lookup","monitorable":true,"description":"Read one Colombian patent case in full by its file number (e.g. `NC2026/0006185`): status and dates, grant, title, abstract, technology sector, every party (applicant, inventor, agent, contact) with identification number and address, the public specification, the procedural history, linked requests and every document of the file with Croma's copy. Answers from Croma's copy within a day of the last read; `found: false` when the register has no patent under the number. Find numbers with `sic_ip_patents_search`.","required":["file_number"],"request_schema":{"file_number":{"type":"string","pattern":"^\\s*(?:[A-Za-z]{2}\\s*\\d{4}\\s*\\/?\\s*\\d{1,7}|\\d{1,10})\\s*$","description":"The case's file number (expediente), e.g. `SD2026/0031979` for a trademark or `NC2026/0006185` for a patent or a design, or the bare digits of a file opened before 2016 (`16137606`). The year's consecutive may be written without its leading zeros."}},"example_request":{"file_number":"NC2026/0006185"}},{"id":"sic-ip-design","name":"SIC Industrial Design","method":"POST","path":"/co/sic-ip/design/v1","url":"https://api.croma.run/co/sic-ip/design/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-ip","country":"Colombia","source":"SIC, Registro de la Propiedad Industrial","rate_limit":"100 requests / 24h","served_from":"lookup","monitorable":true,"description":"Read one Colombian industrial design case in full by its file number (e.g. `NC2026/0004592`): status and dates, registration, title, Locarno classes, every party (applicant, designer, agent, contact) with identification number and address, the figures, the procedural history and every document of the file with Croma's copy. Answers from Croma's copy within a day of the last read; `found: false` when the register has no design under the number. Find numbers with `sic_ip_designs_search`.","required":["file_number"],"request_schema":{"file_number":{"type":"string","pattern":"^\\s*(?:[A-Za-z]{2}\\s*\\d{4}\\s*\\/?\\s*\\d{1,7}|\\d{1,10})\\s*$","description":"The case's file number (expediente), e.g. `SD2026/0031979` for a trademark or `NC2026/0006185` for a patent or a design, or the bare digits of a file opened before 2016 (`16137606`). The year's consecutive may be written without its leading zeros."}},"example_request":{"file_number":"NC2026/0004592"}},{"id":"sic-ip-trademarks-by-owner","name":"SIC Trademarks by Owner","method":"POST","path":"/co/sic-ip/trademarks-by-owner/v1","url":"https://api.croma.run/co/sic-ip/trademarks-by-owner/v1","docs_url":"https://docs.usecroma.com/guides/colombia/sic-ip","country":"Colombia","source":"SIC, Registro de la Propiedad Industrial","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"List every Colombian trademark case of one owner or applicant, by NIT or cédula as the register records it (with or without the NIT's check digit): the file number, certificate, sign, status, vigencia, owners, Nice classes, gazette and the filing date, read from the register now. A portfolio of hundreds of marks takes up to a minute. `found: false` when the register knows no party under the number. Read any case in full with `sic_ip_trademark`.","required":["document_number"],"request_schema":{"document_number":{"type":"string","pattern":"^\\s*\\d[\\d.\\s]{3,14}(?:-\\d)?\\s*$","description":"The owner's or applicant's identification number as the register records it: a company's NIT (with or without its check digit) or a person's cédula, e.g. `890903938`."}},"example_request":{"document_number":"800176089"}},{"id":"suit-procedures-search","name":"Colombia Procedures Search","method":"POST","path":"/co/suit/procedures-search/v1","url":"https://api.croma.run/co/suit/procedures-search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/suit","country":"Colombia","source":"Trámites SUIT","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every procedure (trámite) Colombia's public entities offer in the national register of procedures (SUIT), national and territorial. Free text matches the name, the entity, the purpose and the full information, requirements and fees included. Filter by `order` (`national` or `territorial`), `entity_code`, and the DANE `department_code` and `municipality_code`. Each result links to the procedure on gov.co. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the procedure's name, the entity, its purpose and its full content (requirements, fees, steps, channels)."},"order":{"type":"string","enum":["any","national","territorial"],"default":"any","description":"Optional: `national` for procedures of national entities, `territorial` for departments, districts and municipalities, `any` for both."},"entity_code":{"type":"string","maxLength":20,"default":"","description":"Optional: only procedures of the entity with this code, as `entity_code` gives it in a result (e.g. `5396` for the Registraduría)."},"department_code":{"type":"string","maxLength":2,"default":"","description":"Optional: two-digit DANE code of the entity's department, e.g. `05` for Antioquia, `11` for Bogotá."},"municipality_code":{"type":"string","maxLength":5,"default":"","description":"Optional: five-digit DANE code of the entity's municipality, e.g. `11001` for Bogotá, `05001` for Medellín."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"duplicado cédula","order":"national"}},{"id":"suit-procedure","name":"Colombia Procedure","method":"POST","path":"/co/suit/procedure/v1","url":"https://api.croma.run/co/suit/procedure/v1","docs_url":"https://docs.usecroma.com/guides/colombia/suit","country":"Colombia","source":"Trámites SUIT","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one procedure (trámite) of Colombia's national register of procedures (SUIT) by its número único, e.g. `44` or `T44`, or by its gov.co link: its entity, whether it can be done online, and its full information as markdown, with every step, document, condition, channel, form and fee, the time to obtain, exceptions, legal basis and points of service. `modified_at` says when the entity last updated it. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.","required":["procedure_id"],"request_schema":{"procedure_id":{"type":"string","minLength":1,"maxLength":300,"description":"The procedure's `id` from a search result, e.g. `44` (also as `T44`), or its `official_url` on gov.co."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"procedure_id":"T44"}},{"id":"gov-pages-search","name":"Colombia Entity Procedure Pages Search","method":"POST","path":"/co/gov-pages/search/v1","url":"https://api.croma.run/co/gov-pages/search/v1","docs_url":"https://docs.usecroma.com/guides/colombia/gov-pages","country":"Colombia","source":"Páginas de trámites","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the procedure pages Colombian entities publish on their own sites: requirements, fees and how to pay, where to apply, delivery times and FAQs. Covers the Cancillería (passports, visas, apostilles) and the Unidad para las Víctimas (Registro Único de Víctimas, humanitarian aid, compensation). Free text matches each page's title and full content; filter by `site`. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against each page's title and full text, e.g. `pasaporte costos` or `registro único de víctimas`."},"site":{"type":"string","enum":["","cancilleria","unidad-victimas"],"default":"","description":"Optional: only the pages of `cancilleria` (Ministerio de Relaciones Exteriores) or `unidad-victimas` (Unidad para las Víctimas)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Results per page (1-50)."}},"example_request":{"query":"pasaporte costos","site":"cancilleria"}},{"id":"gov-pages-page","name":"Colombia Entity Procedure Page","method":"POST","path":"/co/gov-pages/page/v1","url":"https://api.croma.run/co/gov-pages/page/v1","docs_url":"https://docs.usecroma.com/guides/colombia/gov-pages","country":"Colombia","source":"Páginas de trámites","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Read one procedure page of a Colombian entity's own site in full, as markdown with its links, by its `id` from a search result or by its address: requirements, fees and how to pay, where to apply, delivery times or FAQs, as the entity publishes them. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.","required":["page_id"],"request_schema":{"page_id":{"type":"string","minLength":1,"maxLength":500,"description":"The page's `id` from a search result, or its `url`."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"page_id":"https://www.cancilleria.gov.co/atencion-y-servicio-al-ciudadano/tramites-y-servicios/pasaportes/costos-y-medios-de-pago"}},{"id":"csj-sv-rulings-search","name":"Corte Suprema de Justicia de El Salvador Rulings Search","method":"POST","path":"/sv/csj-sv/rulings-search/v1","url":"https://api.croma.run/sv/csj-sv/rulings-search/v1","docs_url":"https://docs.usecroma.com/guides/el-salvador/csj","country":"El Salvador","source":"Corte Suprema de Justicia de El Salvador","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the jurisprudencia the Corte Suprema de Justicia de El Salvador publishes: every resolution since 1951 from the Corte Plena and its Salas to the Cámaras, Tribunales de Sentencia and Juzgados. Free text matches the reference number, the court, the decision, the facts, the headnotes and the full text. Filter by `court_type`, `court`, `subject` (the area of law), `proceeding_type`, `type` (the kind of resolution), `crime`, `registration_number` (the reference number), `year` and the ruling date (`from_date`/`to_date`). Each result carries the original document, kept by Croma, and links to the record and the document on the court's own site. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the reference number, the court, the decision, the facts, the headnotes and the full text."},"court_type":{"type":"string","enum":["","corte_plena","sala","camara","tribunal_de_sentencia","juzgado"],"default":"","description":"Optional level of the court: `corte_plena`, `sala` (the Salas of the Corte Suprema), `camara` (the second-instance Cámaras), `tribunal_de_sentencia` or `juzgado`."},"court":{"type":"string","maxLength":160,"default":"","description":"Optional court as `court` names it, e.g. `Sala de lo Constitucional`, matched from the start of the name. Case and accents are ignored."},"subject":{"type":"string","maxLength":120,"default":"","description":"Optional area of law as `subject` names it, e.g. `Penal`, `Familia`, `Civil y Mercantil`, `Constitucional`, `Laboral`, matched from the start. Case and accents are ignored."},"proceeding_type":{"type":"string","maxLength":160,"default":"","description":"Optional kind of proceeding as `proceeding_type` names it, e.g. `Amparo`, `Hábeas corpus`, `Inconstitucionalidad`, matched from the start. Case and accents are ignored."},"type":{"type":"string","maxLength":120,"default":"","description":"Optional kind of resolution as `type` names it, e.g. `Sentencias definitivas`, `Interlocutorias`, `Improcedencias`, matched from the start. Case and accents are ignored."},"crime":{"type":"string","maxLength":200,"default":"","description":"Optional crime as it appears in `crimes`, e.g. `Homicidio agravado`, matched in full. Case and accents are ignored."},"registration_number":{"type":"string","maxLength":80,"default":"","description":"Optional reference number (N°) as the court prints it, e.g. `49COMP2026` or `86-CAC-2026`. Returns every resolution of that reference. Case, spaces and punctuation are ignored."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year of the resolution. 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"debido proceso","court_type":"sala","subject":"constitucional"}},{"id":"csj-sv-ruling","name":"Corte Suprema de Justicia de El Salvador Ruling","method":"POST","path":"/sv/csj-sv/ruling/v1","url":"https://api.croma.run/sv/csj-sv/ruling/v1","docs_url":"https://docs.usecroma.com/guides/el-salvador/csj","country":"El Salvador","source":"Corte Suprema de Justicia de El Salvador","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one resolution from the jurisprudencia of El Salvador's Corte Suprema de Justicia by its `id` from a search result (e.g. `1138697`) or its `official_url`: its full text, the reference number, the court, the area of law, the kind of proceeding and of resolution, the decision, the headnotes, the original document as the court published it, and the links to the record and the document on the court's own site. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.","required":["ruling_id"],"request_schema":{"ruling_id":{"type":"string","minLength":1,"maxLength":600,"description":"The resolution's `id` from a search result, e.g. `1138697`. Its `official_url` works too."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"ruling_id":"1138697"}},{"id":"csj-sv-laws-search","name":"Corte Suprema de Justicia de El Salvador Laws Search","method":"POST","path":"/sv/csj-sv/laws-search/v1","url":"https://api.croma.run/sv/csj-sv/laws-search/v1","docs_url":"https://docs.usecroma.com/guides/el-salvador/csj","country":"El Salvador","source":"Corte Suprema de Justicia de El Salvador","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search El Salvador's legislation as the Corte Suprema de Justicia's documentation center keeps it: more than 10,000 legal texts published in the Diario Oficial since 1821, from the codes and laws to executive decrees, regulations, agreements and municipal ordinances. Free text matches the name, the documentation center's summary and the consolidated text. Filter by `type`, `status` (`vigente`, `caducada`, `derogada`), `subject`, `number`, `municipality`, `department`, `year` and the publication date (`from_date`/`to_date`). Each result carries Croma's copy of the original document and links to the record and the document on the court's own site. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the act's name, the documentation center's summary and the full text."},"type":{"type":"string","maxLength":80,"default":"","description":"Optional kind of document as `type` names it: `Decretos Legislativos`, `Decretos Ejecutivos`, `Decretos Institucionales`, `Acuerdos`, `Reglamentos`, `Ordenanzas Municipales` or `Documentos Generales`, matched from the start. Case and accents are ignored."},"status":{"type":"string","enum":["","vigente","caducada","derogada"],"default":"","description":"Optional status: `vigente` (in force), `caducada` (expired) or `derogada` (repealed)."},"subject":{"type":"string","maxLength":80,"default":"","description":"Optional area of law as `subject` names it, e.g. `Penal`, `Tributaria`, `Laboral`, matched from the start. Case and accents are ignored."},"number":{"type":"string","maxLength":40,"default":"","description":"Optional decree or agreement number, e.g. `1030`. Case, spaces and punctuation are ignored."},"municipality":{"type":"string","maxLength":120,"default":"","description":"Optional municipality of an ordinance, e.g. `San Salvador Centro`, matched from the start. Case and accents are ignored."},"department":{"type":"string","maxLength":80,"default":"","description":"Optional department of an ordinance, e.g. `La Libertad`, matched from the start. Case and accents are ignored."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year of publication in the Diario Oficial. 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"código penal","status":"vigente"}},{"id":"csj-sv-law","name":"Corte Suprema de Justicia de El Salvador Law","method":"POST","path":"/sv/csj-sv/law/v1","url":"https://api.croma.run/sv/csj-sv/law/v1","docs_url":"https://docs.usecroma.com/guides/el-salvador/csj","country":"El Salvador","source":"Corte Suprema de Justicia de El Salvador","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one legal text of El Salvador by its `id` from a search result (e.g. `558819`, the Código Penal) or its `official_url`: its consolidated text, status, every amendment with its act and Croma's copy of its own text, the rulings related to it, and every version of its document Croma has kept. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.","required":["law_id"],"request_schema":{"law_id":{"type":"string","minLength":1,"maxLength":600,"description":"The act's `id` from a search result, e.g. `558819`. Its `official_url` works too."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"law_id":"558819"}},{"id":"asamblea-sv-decrees-search","name":"Asamblea Legislativa de El Salvador Decrees Search","method":"POST","path":"/sv/asamblea-sv/decrees-search/v1","url":"https://api.croma.run/sv/asamblea-sv/decrees-search/v1","docs_url":"https://docs.usecroma.com/guides/el-salvador/asamblea","country":"El Salvador","source":"Asamblea Legislativa de El Salvador","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search every decree of El Salvador's Asamblea Legislativa. Its register holds the laws, codes and regulations and every other legislative decree, from loan authorizations and tax exemptions to elections of officials and honorary distinctions. Free text matches the title, the Asamblea's summary and the full text. Filter by `type` (`Decreto`, `Ley`, `Código`, `Reglamento`), `subject`, `subtopic`, `area_of_law`, `number`, `year` and the date the decree was issued (`from_date`/`to_date`). Each result carries Croma's copy of the decree's document and links to the record and the document on the Asamblea's own site. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the decree's title, the Asamblea's summary and the full text."},"type":{"type":"string","maxLength":40,"default":"","description":"Optional kind of act as `type` names it: `Decreto`, `Ley`, `Código` or `Reglamento`. Case and accents are ignored."},"subject":{"type":"string","maxLength":120,"default":"","description":"Optional subject as `subject` names it, e.g. `Hacienda y Presupuesto`, `Asamblea Legislativa`, `Seguridad Pública`, matched from the start. Case and accents are ignored."},"subtopic":{"type":"string","maxLength":160,"default":"","description":"Optional subtopic as `subtopic` names it, e.g. `Autorizaciones para Préstamos`, `Exenciones (Franquicias)`, `Distinciones Honoríficas`, matched from the start. Case and accents are ignored."},"area_of_law":{"type":"string","maxLength":120,"default":"","description":"Optional area of law as `area_of_law` names it, e.g. `Derecho Administrativo`, `Derecho Penal`, `Derecho Tributario o Fiscal`, matched from the start. Case and accents are ignored."},"number":{"type":"string","maxLength":20,"default":"","description":"Optional decree number, e.g. `632`. Numbers restart with each legislature, so combine it with `year` or dates."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year the Asamblea issued the decree. 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"préstamo","subject":"Hacienda y Presupuesto","year":2026}},{"id":"asamblea-sv-decree","name":"Asamblea Legislativa de El Salvador Decree","method":"POST","path":"/sv/asamblea-sv/decree/v1","url":"https://api.croma.run/sv/asamblea-sv/decree/v1","docs_url":"https://docs.usecroma.com/guides/el-salvador/asamblea","country":"El Salvador","source":"Asamblea Legislativa de El Salvador","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one decree from the register of El Salvador's Asamblea Legislativa by its `id` from a search result (e.g. `7000`) or its `official_url`: its full text, number, kind, dates of issue and publication, Diario Oficial issue, subject, subtopic, area of law, the Asamblea's summary, Croma's copy of its document and the links to the record and the document on the Asamblea's own site. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.","required":["decree_id"],"request_schema":{"decree_id":{"type":"string","minLength":1,"maxLength":300,"description":"The decree's `id` from a search result, e.g. `7000`. Its `official_url` works too."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"decree_id":"7000"}},{"id":"mitur-sv-places-search","name":"El Salvador Tourism Places Search","method":"POST","path":"/sv/mitur-sv/places-search/v1","url":"https://api.croma.run/sv/mitur-sv/places-search/v1","docs_url":"https://docs.usecroma.com/guides/el-salvador/turismo","country":"El Salvador","source":"Ministerio de Turismo de El Salvador","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search El Salvador's official tourism directory, kept by the Ministerio de Turismo: destinations, public and private tourist sites, restaurants, lodging, transport, recreation, tourist information, surf schools and certified tour guides. Free text matches the name, description, address, town and region. Filter by `kind`, `theme` (`surf_city`, `bitcoin`, `nature_adventure`, `archaeology`, `towns`, `wellness`, `regional`), `department`, `municipality`, the `language` a guide works in, and `registered_only` for businesses in the national tourism registry. Businesses carry the contact details the directory publishes; guides carry their languages and area, not personal contacts. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional search terms matched against the name, the description, the address, the town and the region."},"kind":{"type":"string","enum":["","destination","attraction","restaurant","lodging","transport","recreation","tourist_info","surf_school","guide"],"default":"","description":"Optional kind of place: `destination`, `attraction` (a tourist site, public or private), `restaurant`, `lodging`, `transport`, `recreation`, `tourist_info`, `surf_school` or `guide` (a certified tour guide)."},"theme":{"type":"string","enum":["","surf_city","bitcoin","nature_adventure","archaeology","towns","wellness","regional"],"default":"","description":"Optional theme the Ministerio de Turismo files a destination under: `surf_city`, `bitcoin` (its Bitcoin destinations), `nature_adventure`, `archaeology`, `towns`, `wellness` or `regional` (destinations in neighbouring countries)."},"department":{"type":"string","enum":["","Ahuachapán","Cabañas","Chalatenango","Cuscatlán","La Libertad","La Paz","La Unión","Morazán","San Miguel","San Salvador","San Vicente","Santa Ana","Sonsonate","Usulután"],"default":"","description":"Optional department of El Salvador, e.g. `La Libertad`, `Santa Ana`, `Usulután`."},"municipality":{"type":"string","maxLength":80,"default":"","description":"Optional town or municipality, e.g. `Suchitoto`, `Tamanique`, `Concepción de Ataco`, matched from the start. Case and accents are ignored."},"language":{"type":"string","enum":["","es","en","fr","it","de","pt","nah"],"default":"","description":"Optional language a tour guide works in, as an ISO 639 code: `es`, `en`, `fr`, `it`, `de`, `pt` or `nah` (Náhuat)."},"registered_only":{"type":"boolean","default":false,"description":"When true, only businesses inscribed in the national tourism registry (Registro Nacional de Turismo)."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"El Tunco","kind":"lodging","department":"La Libertad"}},{"id":"mitur-sv-place","name":"El Salvador Tourism Place","method":"POST","path":"/sv/mitur-sv/place/v1","url":"https://api.croma.run/sv/mitur-sv/place/v1","docs_url":"https://docs.usecroma.com/guides/el-salvador/turismo","country":"El Salvador","source":"Ministerio de Turismo de El Salvador","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one place from El Salvador's official tourism directory by its `id` from a search result (e.g. `2905`), its `slug` or its `official_url`: everything the search returns plus a destination's description and its photos, each with Croma's copy of the photo and the link to it on the official site.","required":["place_id"],"request_schema":{"place_id":{"type":"string","minLength":1,"maxLength":300,"description":"The place's `id` from a search result, e.g. `2905`. Its `slug` or `official_url` work too."}},"example_request":{"place_id":"2905"}},{"id":"mitur-sv-events-search","name":"El Salvador Tourism Events Search","method":"POST","path":"/sv/mitur-sv/events-search/v1","url":"https://api.croma.run/sv/mitur-sv/events-search/v1","docs_url":"https://docs.usecroma.com/guides/el-salvador/turismo","country":"El Salvador","source":"Ministerio de Turismo de El Salvador","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the official agenda of El Salvador's Ministerio de Turismo: festivals, fairs, concerts, sports and cultural events across the country, each with its dates, venue, department and links for more information. Without `from_date` it returns events that have not ended yet. Filter by date range (`from_date`/`to_date`, matched against the days the event runs), `department` and free text over the name and venue. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional search terms matched against the event's name and venue."},"department":{"type":"string","enum":["","Ahuachapán","Cabañas","Chalatenango","Cuscatlán","La Libertad","La Paz","La Unión","Morazán","San Miguel","San Salvador","San Vicente","Santa Ana","Sonsonate","Usulután"],"default":"","description":"Optional department of El Salvador, e.g. `La Libertad`, `Santa Ana`, `Usulután`."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"department":"San Salvador"}},{"id":"tcp-bo-rulings-search","name":"Tribunal Constitucional Plurinacional de Bolivia Rulings Search","method":"POST","path":"/bo/tcp-bo/rulings-search/v1","url":"https://api.croma.run/bo/tcp-bo/rulings-search/v1","docs_url":"https://docs.usecroma.com/guides/bolivia/tcp","country":"Bolivia","source":"Tribunal Constitucional Plurinacional de Bolivia","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the jurisprudencia of Bolivia's Tribunal Constitucional Plurinacional and its predecessor: every sentencia, auto, declaración and vote since 1999. Free text matches the resolution number, the case numbers, the chamber, the action and the full text. Filter by `type`, `chamber`, `proceeding_type` (the constitutional action), `reporting_judge`, `department`, `registration_number` (the resolution number), `case_number`, `year` and the ruling date (`from_date`/`to_date`). Each result carries the original document, kept by Croma, and a link to the resolution's page at the court. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the resolution number, the case number, the chamber, the action and the full text."},"type":{"type":"string","enum":["","sentencia","auto","declaracion","voto_disidente","voto_aclaratorio","decreto"],"default":"","description":"Optional kind of resolution: `sentencia` (SC, SCP), `auto` (AC, ACP, RCA, ECA...), `declaracion` (DCP), `voto_disidente`, `voto_aclaratorio` or `decreto`."},"chamber":{"type":"string","maxLength":120,"default":"","description":"Optional chamber as `chamber` names it, e.g. `Sala Primera`, `Sala Plena` or `Comisión de Admisión`, matched from the start. Case and accents are ignored."},"proceeding_type":{"type":"string","maxLength":160,"default":"","description":"Optional constitutional action as `proceeding_type` names it, e.g. `Acción de amparo constitucional`, `Acción de libertad`, `Acción de inconstitucionalidad concreta`, matched from the start. Case and accents are ignored."},"registration_number":{"type":"string","maxLength":80,"default":"","description":"Optional resolution number as the court prints it, e.g. `0050/2024-S2` or `0437/2013`. Returns every resolution of that number, including the votes attached to it. Case, spaces and punctuation are ignored."},"case_number":{"type":"string","maxLength":80,"default":"","description":"Optional case file number (expediente) as the court prints it, e.g. `60836-2024-122-AL`. Case, spaces and punctuation are ignored."},"reporting_judge":{"type":"string","maxLength":160,"default":"","description":"Optional reporting justice (magistrado relator) as `reporting_judge` names them, matched from the start of the name. Case and accents are ignored."},"department":{"type":"string","maxLength":60,"default":"","description":"Optional department the case came from, e.g. `La Paz`, `Santa Cruz`, `Cochabamba`, matched from the start. Case and accents are ignored."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year of the resolution. 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"debido proceso","type":"sentencia","proceeding_type":"Acción de amparo"}},{"id":"tcp-bo-ruling","name":"Tribunal Constitucional Plurinacional de Bolivia Ruling","method":"POST","path":"/bo/tcp-bo/ruling/v1","url":"https://api.croma.run/bo/tcp-bo/ruling/v1","docs_url":"https://docs.usecroma.com/guides/bolivia/tcp","country":"Bolivia","source":"Tribunal Constitucional Plurinacional de Bolivia","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one resolution of Bolivia's Tribunal Constitucional Plurinacional by its `id` from a search result (e.g. `202697`) or its `official_url`: its full text, the resolution number, the chamber, the reporting justice, the constitutional action, the department, the case files, the original document as the court published it, and the link to its page at the court. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.","required":["ruling_id"],"request_schema":{"ruling_id":{"type":"string","minLength":1,"maxLength":600,"description":"The resolution's `id` from a search result. Its `official_url` works too."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"ruling_id":"202697"}},{"id":"tsj-bo-rulings-search","name":"Tribunal Supremo de Justicia de Bolivia Rulings Search","method":"POST","path":"/bo/tsj-bo/rulings-search/v1","url":"https://api.croma.run/bo/tsj-bo/rulings-search/v1","docs_url":"https://docs.usecroma.com/guides/bolivia/tsj","country":"Bolivia","source":"Tribunal Supremo de Justicia de Bolivia","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the jurisprudencia of Bolivia's Tribunal Supremo de Justicia: every auto supremo, sentencia and resolución its chambers have published since 2001. Free text matches the resolution and case numbers, the chamber, the area of law, the outcome, the court's jurisprudence notes and the full text. Filter by `chamber`, `type`, `subject`, `outcome`, `registration_number`, `case_number`, `reporting_judge`, `department`, `year` and the ruling date (`from_date`/`to_date`). Each result carries the document, kept by Croma, and a link to the resolution on the court's own site. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional search terms matched against the resolution number, the case number, the chamber, the jurisprudence notes (descriptor, restrictor, ratio decidendi) and the full text."},"chamber":{"type":"string","maxLength":120,"default":"","description":"Optional chamber as `chamber` names it, e.g. `Sala Civil`, `Sala Penal`, `Sala Plena` or `Sala Contenciosa`, matched from the start. Case and accents are ignored."},"type":{"type":"string","enum":["","auto_supremo","sentencia","resolucion"],"default":"","description":"Optional kind of resolution: `auto_supremo`, `sentencia` or `resolucion`."},"subject":{"type":"string","maxLength":120,"default":"","description":"Optional area of law as `subject` names it, e.g. `Civil`, `Penal`, `Familia`, `Social`, `Agrario`, matched from the start. Case and accents are ignored."},"outcome":{"type":"string","maxLength":120,"default":"","description":"Optional outcome as `outcome` names it, e.g. `Infundado`, `Casa`, `Improcedente`, `Anula`, matched from the start. Case and accents are ignored."},"registration_number":{"type":"string","maxLength":80,"default":"","description":"Optional resolution number as the court prints it, e.g. `AS/0001/2013` or `SE/0001/2023`. Each chamber numbers its own resolutions, so a number can return several; add `chamber` to narrow it. Case, spaces and punctuation are ignored."},"case_number":{"type":"string","maxLength":80,"default":"","description":"Optional case file number (expediente) as the court prints it. Case, spaces and punctuation are ignored."},"reporting_judge":{"type":"string","maxLength":160,"default":"","description":"Optional reporting justice (magistrado relator) as `reporting_judge` names them, matched from the start of the name. Case and accents are ignored."},"department":{"type":"string","maxLength":60,"default":"","description":"Optional department the case came from, e.g. `La Paz`, `Santa Cruz`, `Chuquisaca`, matched from the start. Case and accents are ignored."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year of the resolution. 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"nulidad de contrato","chamber":"Sala Civil","type":"auto_supremo"}},{"id":"tsj-bo-ruling","name":"Tribunal Supremo de Justicia de Bolivia Ruling","method":"POST","path":"/bo/tsj-bo/ruling/v1","url":"https://api.croma.run/bo/tsj-bo/ruling/v1","docs_url":"https://docs.usecroma.com/guides/bolivia/tsj","country":"Bolivia","source":"Tribunal Supremo de Justicia de Bolivia","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one resolution of Bolivia's Tribunal Supremo de Justicia by its `id` from a search result (e.g. `11378`) or its `official_url`: its full text, the resolution and case numbers, the chamber, the kind of resolution and how it was resolved, the area of law, the reporting justice, the court's jurisprudence notes, the document as the court published it, and a link to the resolution on the court's own site. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.","required":["ruling_id"],"request_schema":{"ruling_id":{"type":"string","minLength":1,"maxLength":600,"description":"The resolution's `id` from a search result. Its `official_url` works too."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"ruling_id":"11378"}},{"id":"nta-companies-search","name":"National Tax Agency Companies Search","method":"POST","path":"/jp/nta/companies-search/v1","url":"https://api.croma.run/jp/nta/companies-search/v1","docs_url":"https://docs.usecroma.com/guides/japan/nta","country":"Japan","source":"National Tax Agency of Japan","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search Japan's corporate number register (法人番号), about six million companies and other legal entities, by any part of the name in kanji, kana or English, narrowed by `prefecture` (name or JIS code), `city`, `entity_type` (the legal form), `status` (`active` or `closed`), `change_type` (the last change the register recorded) and the date of that change (`from_date`/`to_date`). Each result carries the corporate number, the names, the legal form, the head office, the registration status with any closure, and the last change. Served by Croma from its copy of the register (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":200,"default":"","description":"Optional company name, or any part of it, as the register spells it: in Japanese (`トヨタ自動車`, `トヨタ`), in its reading (`トヨタジドウシャ`) or in English where the company registered one (`Toyota`). Two or more characters; every word must appear."},"prefecture":{"type":"string","maxLength":40,"default":"","description":"Optional prefecture of the head office, as the register prints it (`東京都`, `大阪府`, `北海道`, `沖縄県`) or as its two-digit JIS code (`13` for Tokyo)."},"city":{"type":"string","maxLength":60,"default":"","description":"Optional city, ward, town or village of the head office as the register prints it, e.g. `千代田区`, `横浜市西区`, `豊田市`, matched from the start."},"entity_type":{"type":"string","enum":["","national_government","local_government","kabushiki_kaisha","yugen_kaisha","gomei_kaisha","goshi_kaisha","godo_kaisha","other_registered","foreign_company","other"],"default":"","description":"Optional legal form: `kabushiki_kaisha` (株式会社), `yugen_kaisha` (有限会社), `gomei_kaisha` (合名会社), `goshi_kaisha` (合資会社), `godo_kaisha` (合同会社), `other_registered` (other registered entities such as 一般社団法人, 医療法人, 学校法人), `foreign_company` (外国会社), `national_government`, `local_government` or `other`."},"status":{"type":"string","enum":["","active","closed"],"default":"","description":"Optional registration status: `active` (the register record is open) or `closed` (closed after liquidation, a merger or by the registrar)."},"change_type":{"type":"string","enum":["","new","name_change","address_change","foreign_address_change","closed","revived","merger","merger_annulled","trade_name_erased","deleted"],"default":"","description":"Optional kind of the last change the register recorded for the company: `new` (number assigned), `name_change`, `address_change`, `foreign_address_change`, `closed`, `revived`, `merger` (absorbed into another company), `merger_annulled`, `trade_name_erased` or `deleted`. With `from_date` and `to_date`, this finds for example every company registered in a period."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"トヨタ自動車","prefecture":"愛知県"}},{"id":"nta-company","name":"National Tax Agency Company","method":"POST","path":"/jp/nta/company/v1","url":"https://api.croma.run/jp/nta/company/v1","docs_url":"https://docs.usecroma.com/guides/japan/nta","country":"Japan","source":"National Tax Agency of Japan","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one Japanese company or other legal entity by its 13-digit corporate number (法人番号), e.g. `1180301018771`: the registered name with its reading and English form, the legal form, the head office, the registration status with any closure and successor, and the last change the register recorded. Served by Croma from its copy of the register (`as_of` says how current the data is).","required":["corporate_number"],"request_schema":{"corporate_number":{"type":"string","minLength":13,"maxLength":20,"pattern":"^\\d{13}$","description":"The company's 13-digit corporate number (法人番号), e.g. `1180301018771`. The first digit checks the other twelve."}},"example_request":{"corporate_number":"1180301018771"}},{"id":"courts-jp-rulings-search","name":"Courts of Japan Rulings Search","method":"POST","path":"/jp/courts-jp/rulings-search/v1","url":"https://api.croma.run/jp/courts-jp/rulings-search/v1","docs_url":"https://docs.usecroma.com/guides/japan/courts","country":"Japan","source":"Courts of Japan","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Search the case law the courts of Japan publish: about 68,000 rulings of the Supreme Court, the high courts and the lower courts since 1947, across the administrative, labour and intellectual property collections too. Free text in Japanese matches the case name, the court's summary, the statutes cited and the full text. Filter by `collection`, `court` (matched from the start of its name), `case_number`, `year` and the ruling date (`from_date`/`to_date`). Each result carries the court's document, kept by Croma, and a link to the ruling's page at the courts. Served by Croma (`as_of` says how current the data is).","required":[],"request_schema":{"query":{"type":"string","maxLength":300,"default":"","description":"Optional words, in Japanese, matched against the case name, the court's summary (判示事項, 裁判要旨), the statutes cited and the text of the ruling: `解雇権濫用`, `過払金 返還`. Two or more characters; every word must appear."},"collection":{"type":"string","enum":["","supreme","high","lower","administrative","labor","ip","ip_high"],"default":"","description":"Optional collection: `supreme` (最高裁判所判例集), `high` (高等裁判所判例集), `lower` (下級裁判所裁判例速報), `administrative` (行政事件裁判例集), `labor` (労働事件裁判例集), `ip` (知的財産裁判例集) or `ip_high` (知的財産高等裁判所). A ruling can sit in more than one."},"court":{"type":"string","maxLength":80,"default":"","description":"Optional court as `court` names it, e.g. `最高裁判所第一小法廷`, `東京高等裁判所`, `大阪地方裁判所`, matched from the start, so `最高裁判所` finds every bench of the Supreme Court."},"case_number":{"type":"string","maxLength":60,"default":"","description":"Optional case number as the court prints it, e.g. `平成21(オ)257` or `令和7(あ)868`. Spaces and the width of the characters are ignored."},"year":{"type":"integer","minimum":0,"maximum":2100,"default":0,"description":"Optional year the ruling was handed down (Gregorian). 0 searches every year."},"from_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"to_date":{"type":"string","format":"date","default":"","description":"Optional date filter in yyyy-mm-dd format."},"page":{"type":"integer","minimum":1,"maximum":1000,"default":1,"description":"1-based page number for paginated results."},"per_page":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Results per page (1-50)."}},"example_request":{"query":"解雇権濫用","collection":"supreme"}},{"id":"courts-jp-ruling","name":"Courts of Japan Ruling","method":"POST","path":"/jp/courts-jp/ruling/v1","url":"https://api.croma.run/jp/courts-jp/ruling/v1","docs_url":"https://docs.usecroma.com/guides/japan/courts","country":"Japan","source":"Courts of Japan","rate_limit":"100 requests / 24h","served_from":"dataset","monitorable":true,"description":"Retrieve one ruling of the courts of Japan by its `id` from a search result (e.g. `93117`) or its `official_url`: its full text, the case number and name, the court, the date, the outcome, the court's summary and the statutes cited, the court's document as published, and the link to its page at the courts. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.","required":["ruling_id"],"request_schema":{"ruling_id":{"type":"string","minLength":1,"maxLength":600,"description":"The ruling's `id` from a search result, e.g. `93117`. Its `official_url` or `source_document_url` works too."},"offset":{"type":"integer","minimum":0,"maximum":10000000,"default":0,"description":"First character of the range to return. Pass the previous response's `next_offset` to continue reading."},"limit":{"type":"integer","minimum":1000,"maximum":1000000,"default":200000,"description":"Maximum characters to return (1000-1000000)."}},"example_request":{"ruling_id":"93117"}},{"id":"bancolombia-accounts","name":"Bancolombia Accounts","method":"POST","path":"/co/bancolombia/accounts/v1","url":"https://api.croma.run/co/bancolombia/accounts/v1","docs_url":"https://docs.usecroma.com/guides/colombia/bancolombia","country":"Colombia","source":"Bancolombia","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Read the accounts the connected Bancolombia customer holds, with their type, currency and available balance. Runs as your organization's own Bancolombia connection.","required":[],"request_schema":{"connection_id":{"type":"string","default":"","description":"Optional. Run as this connection (`conn_…`). Empty lets Croma pick among your organization's connections, moving to the next one when one reaches its daily allowance."}},"example_request":{}},{"id":"bancolombia-transactions","name":"Bancolombia Transactions","method":"POST","path":"/co/bancolombia/transactions/v1","url":"https://api.croma.run/co/bancolombia/transactions/v1","docs_url":"https://docs.usecroma.com/guides/colombia/bancolombia","country":"Colombia","source":"Bancolombia","rate_limit":"100 requests / 24h","served_from":"live","monitorable":true,"description":"Read the movements of one of the connected customer's Bancolombia accounts over a date window: date, description, amount, the movement type and a reference. Runs as your organization's own Bancolombia connection.","required":["account_number","date_from","date_to"],"request_schema":{"account_number":{"type":"string","pattern":"^\\d{6,20}$","description":"The account number to read movements for, digits only, as it appears in the accounts list."},"date_from":{"type":"string","format":"date","description":"The first day of the movements window, inclusive, `yyyy-mm-dd`."},"date_to":{"type":"string","format":"date","description":"The last day of the movements window, inclusive, `yyyy-mm-dd`."},"connection_id":{"type":"string","default":"","description":"Optional. Run as this connection (`conn_…`). Empty lets Croma pick among your organization's connections, moving to the next one when one reaches its daily allowance."}},"example_request":{"account_number":"12345678901","date_from":"2026-01-01","date_to":"2026-03-31"}},{"id":"web-search","name":"Web Search","method":"POST","path":"/global/web-search/v1","url":"https://api.croma.run/global/web-search/v1","docs_url":"https://docs.usecroma.com/guides/global/web-search","country":"Global","source":"Croma","rate_limit":"100 requests / 1h, within 100 requests / 24h","served_from":"live","monitorable":false,"description":"AI-powered web search. Returns structured results with URLs, titles, authors, dates, highlights, and relevance scores.","required":["query"],"request_schema":{"query":{"type":"string","minLength":3,"maxLength":300,"description":"Natural-language search query."},"limit":{"type":"integer","minimum":1,"maximum":25,"default":10,"description":"Number of results to return."}},"example_request":{"query":"croma api colombia"}},{"id":"extract-markdown","name":"Extract Markdown","method":"POST","path":"/global/extract/markdown/v1","url":"https://api.croma.run/global/extract/markdown/v1","docs_url":"https://docs.usecroma.com/guides/global/extract","country":"Global","source":"Croma","rate_limit":"60 requests / 1h, within 100 requests / 24h","served_from":"live","monitorable":false,"description":"Turn any public web page into clean Markdown. `scope` keeps either the article body or the whole page, and `include_metadata` adds the page's title, author, published date and image. Handles pages that render themselves in the browser at `effort: max`.","required":["url"],"request_schema":{"url":{"type":"string","format":"uri","maxLength":2000,"description":"Public http or https URL of the page to read. Loopback and private addresses are not accepted."},"scope":{"type":"string","enum":["main","full"],"default":"main","description":"`main` keeps the article body and drops navigation and boilerplate; `full` keeps the whole page."},"effort":{"type":"string","enum":["min","standard","max"],"default":"standard","description":"Effort to spend on the page: `min` is fastest and may serve a recent copy, `standard` is the balanced default, `max` always reads the page live and handles pages that render themselves in the browser."},"include_metadata":{"type":"boolean","default":false,"description":"Include the page's title, author, published date and image in the response."}},"example_request":{"url":"https://www.funcionpublica.gov.co/eva/gestornormativo/norma.php?i=304"}},{"id":"extract-json","name":"Extract JSON","method":"POST","path":"/global/extract/json/v1","url":"https://api.croma.run/global/extract/json/v1","docs_url":"https://docs.usecroma.com/guides/global/extract","country":"Global","source":"Croma","rate_limit":"60 requests / 1h, within 100 requests / 24h","served_from":"live","monitorable":false,"description":"Pull structured data off any public web page. You supply a JSON Schema describing the object you want and the fields are located on the page and returned under `result`, already typed.","required":["url","json_schema"],"request_schema":{"url":{"type":"string","format":"uri","maxLength":2000,"description":"Public http or https URL of the page to read. Loopback and private addresses are not accepted."},"json_schema":{"type":"object","description":"JSON Schema for the object to return. Field names and nesting are yours; describe each field so it can be located on the page."},"effort":{"type":"string","enum":["min","standard","max"],"default":"standard","description":"Effort to spend on the page: `min` is fastest and may serve a recent copy, `standard` is the balanced default, `max` always reads the page live and handles pages that render themselves in the browser."}},"example_request":{"url":"https://www.funcionpublica.gov.co/eva/gestornormativo/norma.php?i=304","json_schema":{"type":"object","required":["title"],"properties":{"title":{"type":"string","description":"Nombre de la norma."},"issued_on":{"type":"string","description":"Fecha de expedición."}}}}},{"id":"generate-json","name":"Generate JSON","method":"POST","path":"/global/generate/json/v1","url":"https://api.croma.run/global/generate/json/v1","docs_url":"https://docs.usecroma.com/guides/global/generate","country":"Global","source":"Croma","rate_limit":"60 requests / 1h, within 100 requests / 24h","served_from":"live","monitorable":false,"description":"Read a public web page and return a new object built from it, following your `instructions` and your JSON Schema. Unlike `extract-json`, the fields need not appear on the page: summarize, classify, translate or reshape what is there.","required":["url","instructions","json_schema"],"request_schema":{"url":{"type":"string","format":"uri","maxLength":2000,"description":"Public http or https URL of the page to read. Loopback and private addresses are not accepted."},"instructions":{"type":"string","minLength":3,"maxLength":20000,"description":"What to do with the page: summarize, classify, translate, reformat. Write it as you would brief an analyst."},"json_schema":{"type":"object","description":"JSON Schema for the object to return. Field names and nesting are yours; describe each field so it can be located on the page."},"effort":{"type":"string","enum":["min","standard","max"],"default":"standard","description":"Effort to spend on the page: `min` is fastest and may serve a recent copy, `standard` is the balanced default, `max` always reads the page live and handles pages that render themselves in the browser."}},"example_request":{"url":"https://www.funcionpublica.gov.co/eva/gestornormativo/norma.php?i=304","instructions":"Resume la norma en dos frases y clasifica su materia principal.","json_schema":{"type":"object","required":["summary","subject"],"properties":{"summary":{"type":"string"},"subject":{"type":"string"}}}}},{"id":"research","name":"Research","method":"POST","path":"/global/research/v1","url":"https://api.croma.run/global/research/v1","docs_url":"https://docs.usecroma.com/guides/global/research","country":"Global","source":"Croma","rate_limit":"10 requests / 1h, within 100 requests / 24h","served_from":"live","monitorable":false,"description":"Answer an open question from live sources. Returns a written report in Markdown with numbered citations plus the list of sources behind it. Typically takes a few seconds; it is a research pass, not a lookup, so verify anything you act on against the primary source.","required":["query"],"request_schema":{"query":{"type":"string","minLength":10,"maxLength":2000,"description":"The question to research, in plain language."}},"example_request":{"query":"¿Qué cambios trajo la Ley 2195 de 2022 en materia de responsabilidad de personas jurídicas en Colombia?"}}]}}