Guide · Honduras · API

Honduras company data API: look up a company by its RTN

The legal entities that sold to the Honduran state since 2005, from the open contracting data of the ONCAE, 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.

Honduras at a glance

Register: ONCAE open contracting data, a partial list of state suppliers

Identifiers RTN (Registro Tributario Nacional)

  • 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 Honduras live

Look up a company in Honduras 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=HN. A company is found by its RTN (company_number) or by name:

# by RTN
curl -H "Authorization: Bearer rk_live_..." \
  "https://api.prometiam.com/functions/v1/risk-api/companies/search?company_number=01019002005278&country=HN"

# by name
curl -H "Authorization: Bearer rk_live_..." \
  "https://api.prometiam.com/functions/v1/risk-api/companies/search?name=distribuidora&country=HN"

The RTN is 14 digits with a 9 in the fifth place (the legal-entity range). No check digit is published, so only the shape is tested; a malformed number, or one with another digit in the fifth place, answers with a 400 validation error. Dashes, spaces and dots are accepted and the number is stored as 14 digits.

What a record holds

FieldNotes
company_numberThe RTN, 14 digits.
company_nameThe legal name, from the company's newest award.
addressThe street line as filed. There is no city or region.
statusAlways null: the list carries no status.

The legal name, the RTN and the street line as filed (no city or region). 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

Honduras 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 Honduras. 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 14-digit RTN in the legal-entity range that sold to the Honduran state since 2005 are served. A company that never sold to the state is absent. National identity numbers (people) and the internal codes of the ONCAE are never served. The "compra menor" tag of the purchasing channel is removed from names. 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.

Source and related guides

Contains data from the Oficina Normativa de Contratación y Adquisiciones del Estado (ONCAE) of Honduras, the legal entities that sold to the Honduran state since 2005, published through the Open Contracting Data Registry (https://data.open-contracting.org/en/publication/122) under the Creative Commons Attribution 4.0 (CC BY 4.0) licence. Adapted by Prometiam (legal entities only, one record per company); not Honduras's company register and not an official extract.