Las personas jurídicas que ofertaron al Estado guatemalteco o le vendieron, según los datos abiertos de Guatecompras, en el mismo formato que los demás países. Es una lista parcial de oferentes y proveedores del Estado, no un registro mercantil. Esta es la llamada, los campos y lo que la lista no contiene.
Prometiam es una API REST de pago que devuelve los datos oficiales de empresas de cada país en un formato único. Para Guatemala, envíe country=GT con el NIT (Número de Identificación Tributaria) o un nombre. La fuente son los datos abiertos de Guatecompras (Ministerio de Finanzas Públicas): una lista parcial de oferentes y proveedores del Estado, no el registro de empresas de Guatemala.
| Campo | Contenido |
|---|---|
company_number | El NIT, escrito cuerpo, guion y dígito de control (por ejemplo 10021019-8) |
company_name | La razón social, la de su adjudicación más reciente |
address, city, region | La dirección, la localidad (ciudad) y el departamento (región) |
legal_form_full | El tipo de persona jurídica como texto; no hay código de forma jurídica |
status | Siempre null: los datos no llevan estado |
El NIT es un cuerpo de 3 a 11 dígitos, un guion y un dígito de control (0 a 9 o K), escrito 10021019-8; el guion es opcional. El dígito de control (módulo 11) se exige: uno erróneo o un número mal formado recibe un error 400 (validation_error).
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=GT&company_number=10021019-8' \ -H 'Authorization: Bearer rk_live_...'
La respuesta es una lista data; el id de cada entrada sirve para llamar a GET /companies/{id} y obtener la ficha completa. Una búsqueda por nombre (name=) funciona igual.
status es null; una empresa sigue en la lista después de cerrar.vat se rechaza.POST /monitor rechaza Guatemala.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.
Una clave y la misma llamada para todos los países abiertos. Los precios son públicos: Starter 9,99 € al mes con 1.000 créditos, Professional 29,99 € con 10.000, Scale 99,99 € con 50.000; Enterprise a medida. Una búsqueda o una ficha cuesta 1 crédito; un error no cuesta nada.
Versión en inglés: Guatemala company data API.
Regístrate · Documentación de la API
La prueba dura 14 días e incluye 500 créditos. Se pide una tarjeta, pero no se cobra nada durante la prueba; después sigue el plan Starter (9,99 € al mes) salvo que la canceles.