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 up

Try 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

FieldNotes
company_numberThe RUC, 11 digits.
company_nameThe legal name, from the company's newest award.
addressThe street, where the data gives one (few records do). City, region and postal code are never served.
statusAlways 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.