Guide · Peru · API
Peru company data API: look up a company by its RUC
The legal entities that sold to the Peruvian state since 2003, from the open contracting data of the OECE, in the same record shape as every other country: one key, one call, the source credited. It is a partial list of state suppliers, not a company register. Here is the call, the fields, and what the list does not contain.
Peru at a glance
Register: OECE open contracting data, a partial list of state suppliers
Identifiers RUC (Registro Único de Contribuyentes)
- 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 Peru live
Look up a company in Peru 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=PE. A company is found by its RUC (company_number) or by name:
# by RUC curl -H "Authorization: Bearer rk_live_..." \ "https://api.prometiam.com/functions/v1/risk-api/companies/search?company_number=20100001498&country=PE" # by name curl -H "Authorization: Bearer rk_live_..." \ "https://api.prometiam.com/functions/v1/risk-api/companies/search?name=ferreteria&country=PE"
The RUC is 11 digits starting 20, and its check digit (SUNAT's modulo 11) is enforced: a wrong one, a RUC starting 10, 15 or 17, or a malformed number answers with a 400 validation error. Spaces, dots, hyphens and a leading RUC are accepted.
What a record holds
| Field | Notes |
|---|---|
company_number | The RUC, 11 digits. |
company_name | The legal name, from the company's newest award. |
address | The street, where the data gives one (few records do). City, region and postal code are never served. |
status | Always null: the list carries no status. |
The legal name, the RUC and, where the data gives one, the street address (few records have one). There is no status, no founding or registration date, no legal form, 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
Peru has no register-change events and no company monitoring: the list is read once a month and carries no status or dates, so there is nothing to date a change by. POST /monitor refuses Peru. 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 RUC starting 20 that sold to the Peruvian state since 2003 are served; E.I.R.L. are included. A company that never sold to the state is absent. Sole traders (RUC 10, 15 and 17) and foreign tax numbers are never served, and no natural person is served. The list carries no status, so a supplier stays on it after it closes. A record holds one name and one address, those of the company's newest award, so a name can change from one month to the next.
Source and related guides
Contains data from the Organismo Especializado para las Contrataciones Públicas Eficientes (OECE) of Peru, the legal entities that sold to the Peruvian state since 2003, published through the Open Contracting Data Registry (https://data.open-contracting.org/en/publication/135) under the Creative Commons Attribution 4.0 (CC BY 4.0) licence. Adapted by Prometiam (legal entities only, one record per company); not Peru's company register and not an official extract.