Guide · Guatemala · API
Guatemala company data API: look up a company by its NIT
The legal entities that bid to or sold to the Guatemalan state, from the Guatecompras open data, in the same record shape as every other country: one key, one call, the source credited. It is a partial list of bidders and suppliers, not a company register. Here is the call, the fields, and what the list does not contain.
Guatemala at a glance
Register: Guatecompras open data, a partial list of bidders and suppliers of the state
Identifiers NIT (Número de Identificación Tributaria)
- Company recordsPartial list of state suppliers
- OfficersNo
- Insolvency noticesNo
- Corporate eventsNo
- MonitoringNo
- Financial statementsNo
- VAT numberNo
- NACE classNo
- UpdatedMonthly
The guide below states the limits of every row. Financial statements are on the Scale plan and above; the other plans and the free trial get 10 calls a month.
Price From EUR 9.99 a month (Starter plan)
In other languagesEspañol
Sign upTry Guatemala live
Look up a company in Guatemala with the shared demo key. No sign-up.
The demo key is shared and capped per page view; your own key has the limits of your plan.
The call
The same endpoint as every other live country, with country=GT. A company is found by its NIT (company_number) or by name:
# by NIT curl -H "Authorization: Bearer rk_live_..." \ "https://api.prometiam.com/functions/v1/risk-api/companies/search?company_number=10021019-8&country=GT" # by name curl -H "Authorization: Bearer rk_live_..." \ "https://api.prometiam.com/functions/v1/risk-api/companies/search?name=comercial&country=GT"
The NIT is a body of 3 to 11 digits, a dash and a check digit (0 to 9 or K), written 10021019-8; the dash is optional. The check digit (modulo 11) is enforced: a wrong one or a malformed number answers with a 400 validation error.
What a record holds
| Field | Notes |
|---|---|
company_number | The NIT, written body-dash-check digit (10021019-8). |
company_name | The legal name, from the company's newest award. |
address, city, region | The street, the locality (city) and the department (region). |
legal_form_full | The legal-entity type as text. There is no legal form code. |
status | Always null: the data carries no status. |
The legal name, the NIT, the street address, the locality (city), the department (region) and the legal-entity type as text (legal_form_full). There is no status, no founding or registration date, no legal form code, no activity code, no share capital, no head count, no officers, no contacts, no VAT number, no financial statements and no insolvency notices. There are no register-change events and no company monitoring.
Events and monitoring
Guatemala has no register-change events and no company monitoring: the data is read once a month and carries no status or dates, so there is nothing to date a change by. POST /monitor refuses Guatemala. The data is updated every month, with a lag: the newest awards are not in yet.
What is not in it
Only legal entities with a NIT that bid to or sold to the Guatemalan state are served. The data does not separate winners from bidders, so a company that only bid is served too; a company that never bid is absent. Natural persons (type INDIVIDUAL) and co-ownerships of persons (type COPROPIEDAD) are never served. The list carries no status, so a company stays on it after it closes. A record holds one name and one address, those of the company's newest award.
Source and related guides
Contains data from Guatecompras, Ministerio de Finanzas Públicas of Guatemala, the legal entities that bid to or sold to the Guatemalan state, published as open contracting data (https://ocds.guatecompras.gt/descarga-datos) under the Creative Commons Attribution 4.0 (CC BY 4.0) licence. Adapted by Prometiam (legal entities only, one record per company); not Guatemala's company register and not an official extract.