Start here
This guide contains public integration notes for Hungary. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.Hungary coverage, pricing, and sources
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
Data Sources
Hungary uses two distinct registries depending on the entity type, plus a ministry portal that backs prefill mode:Commercial Companies: OCCSZ
The OCCSZ (Országos Cégnyilvántartó és Céginformációs Szolgálat, National Company Register and Company Information Service) operates the official Hungarian company register (Cégjegyzék):- Company search: Search by name, registration number, and tax number. Returns company name, registration number, address, tax number, and status.
- Trade Register Extract (Cégkivonat): The official extract for each registered company. This is the primary source for company profile data in verification mode: legal name, legal form, registration date, share capital, tax number, registered address, legal representatives, auditors, supervisory board members, shareholders, activity codes (TEÁOR), establishments, and company status.
- Trade Register History (Cégmásolat): The historical register copy. For a struck-off company the register no longer issues a current extract, so this document is issued instead.
Company profile is derived from the Trade Register Extract. Addresses, legal
form standardization (ISO 20275), people, shareholders and roles are enriched
with AI when the extract is read.
Prefill Mode: Cégportál Stored Extract
mode: "prefill" reads the stored company extract (Tárolt cégkivonat) published on Cégportál by the Ministry of Justice under decree 47/2007. (X. 20.) IRM § 5 (1) a). It returns the same five datapoints as verification mode: company, legalRepresentatives, shareholders, otherKeyPersons and establishments.
The register re-renders this extract periodically, not on every change, so prefill mode is not authoritative. A recent filing may not be reflected yet. It also issues no certified document. The Cégkivonat and Cégmásolat are available in verification mode only.
Use prefill mode for screening and enrichment at volume. Use verification mode, the default, when you need the current register position or a certified document.
Sole Traders: NAV EVNY
The NAV EVNY (Egyéni Vállalkozók Nyilvántartása, Sole Traders Registry) is operated by the Hungarian Tax Authority (NAV). This is a separate registry from the Cégjegyzék.- EVNY lookup: Search by registration number (Nyilvántartási szám, 8 digits) or tax number (Adószám, 8 digits). Returns the trader’s name, address, activity codes, status, and registration dates.
- EVNY Extract: A PDF extract of the trader’s EVNY record, available as a document for sole traders.
Sole trader profiles are structured at the source. The register returns
structured fields, so the data is mapped directly without AI enrichment
(except address geocoding).
Financial Statements: e-beszámoló
The e-beszámoló (Electronic Financial Statements Portal,https://e-beszamolo.im.gov.hu) is the Ministry of Justice repository where every company keeping double-entry accounts publishes its annual accounts (beszámoló).
- Financial Statements (Éves beszámoló): The published annual accounts for a company — balance sheet (mérleg) and income statement (eredménykimutatás), plus, where filed, the supplementary notes (kiegészítő melléklet), the profit-distribution resolution, and the independent auditor’s report. One document is available per published fiscal year, retrieved live from the portal and billed per document. When the filed document is a PDF or XML, the balance sheet and income statement are also extracted into structured
extractedFinancialData.
Financial statements are company-only. Sole traders (Egyéni Vállalkozó,
EVNY) keep simplified records and are not required to prepare or publish
annual accounts, so no financial statements are available for them.
Company Identifiers
Query Identifiers
Identifiers in API Response
Once you retrieve company data, theidentifiers object contains all available identifiers for that entity:
Legal Entity Identifier (LEI)
GLEIF is the supplementary data source for this identifier.company.identifiers.lei is optional. It is returned when the company registration number (companyNumber) matches exactly one LEI through a GLEIF registration or validation reference.
The Legal Entity Identifier has 20 uppercase alphanumeric characters, ending in two check digits.
Coverage varies by entity. An absent lei does not prove that the company has no LEI. Lapsed, retired or merged LEIs may be returned; annulled LEIs are excluded.
Search Capabilities
8-digit queries search both registries. A pure 8-digit input is ambiguous
(could be a sole trader registration number or a tax number), so it is searched
in both OCCSZ (by tax number) and EVNY (by both registration number and tax
number) in parallel. Results are deduplicated.
Company Profile
For/v2/company company-data requests, use the 10-digit Cégjegyzékszám for companies or the 8-digit Nyilvántartási szám for sole traders:
- Company:
0109430929,0106216884,01-09-430929 - Sole trader:
57478665,59173988
Active companies only
Search can return companies that are no longer active. Each result carries the register’s status, soactiveOnly=true removes the inactive ones. Companies being registered or in the course of deletion are kept, as their status is transitional.
Company Status
Company status is determined deterministically from the Trade Register Extract. AI is used only to refine the closure reason of a deleted company when the register’s deletion method matches no known pattern.Status Logic
Status is determined in priority order from the Trade Register Extract:Closure Reasons
When status is Closed, the closure reason is derived from the “Megjegyzés” (remark) field in §1 or from the quoted status in the company name:Struck-off companies. When the register no longer issues a current extract
for a company, the profile returns the legal name, identifiers and a
Törölve
closed status, without a closure reason or date. See Documents by Entity
Type.Sole Trader Status (EVNY)
Sole trader status is determined from the EVNY API’s structured fields:Legal Forms
The local legal form (Cégforma) is extracted deterministically from the TRE and then enriched with AI for ISO 20275 code and standardized company type.Key Business Forms
Sole Entrepreneurs
Foreign Entities
Other Forms
Legal form standardization and ISO 20275 assignment are AI-enriched; the local
Hungarian legal form name is always preserved verbatim from the TRE.
Legal Representatives
Legal representatives are extracted from Section 13 (§13) of the Trade Register Extract: “A vezető tisztségviselő(k), a képviseletre jogosult(ak) adatai” (Data of executive officers and those authorized to represent).Extraction Details
- Individual representatives: Name, birth date, residence address (Hungarian or foreign), role, start date, tax ID
- Company representatives: Legal name, registered address, role, start date
- Representation mode: Extracted deterministically from Hungarian signing authority terms in §13. Each legal representative includes a
representationModefield indicating how they can sign for the company:{ mode: "sole" }: Can sign alone (“önálló” or “egyedüli”){ mode: "joint" }: Must sign jointly with others (“együttes”)null: No signing authority explicitly stated
Legal Representative Roles
Common Hungarian register roles and their usual classification:Known register titles have fixed English translations and standardized roles.
Unlisted exact titles retain the AI enrichment fallback. Signing authority uses the register section and recorded powers; it is not inferred from a title.
The original Hungarian role name is always preserved as
localName.Other Key Persons
The TRE contains additional personnel data beyond legal representatives:- Auditors (§14): Both audit firms and individually responsible auditors, with name, address, and registration number
- Supervisory Board Members (§15): Name, birth date, address, start date
- Other employees with registered signing rights (
más munkavállaló, §13): returned as other key persons. This person category does not expose their registered signing mode.
cégvezető means Company Manager, rather than Managing Director; any representation grant and signing mode are separate register facts.
Shareholders
Shareholder data is extracted from Part II of the Trade Register Extract when available. The TRE contains structured ownership information including:- Individual shareholders: Name, birth date, address, share amount/percentage, voting rights
- Company shareholders: Legal name, registration number, address, share amount/percentage
Shareholder data availability depends on the company type and the TRE content.
Not all company types include Part II (ownership section) in their TRE.
Activity Code Mapping
Hungary uses the TEÁOR (Tevékenységek Egységes Ágazati Osztályozási Rendszere) classification, the Hungarian adaptation of NACE. The extract marks each code as TEÁOR’08 (NACE Rev. 2) or TEÁOR’25 (NACE Rev. 2.1). TEÁOR’08 codes are converted to NACE Rev. 2.1; TEÁOR’25 codes are already Rev. 2.1 and pass through unchanged. Stamped codes are returned under the revision-explicitTEAOR_2008 or TEAOR_2025 key. Only unstamped codes use TEAOR. Activity codes are mapped across three levels:
One code in, one code out. You get one
NACE and one ISIC code per declared TEÁOR code. Where a TEÁOR code has no single equivalent in the target revision, the shared parent class is returned rather than every candidate — see One code in, one code out.
TEÁOR codes are extracted directly from the TRE and are never AI-inferred.
The main activity is identified when the TRE marks it as “Főtevékenység” (main
activity). For sole traders, the EVNY register declares the main activity the
same way (fő tevékenység).
Main activity. The register-declared main activity (“Főtevékenység”) is
flagged with
isMainActivity: true on the TEÁOR classification and listed
first. The NACE and ISIC codes derived from it inherit the flag. Codes without
the flag are not necessarily secondary: absence means the register did not
mark them.Data Availability Matrix
Legend: ✅ Available | ❌ Not Available | ⚠️ Conditionally Available | Async = Asynchronous processing
Egyéni Cég (EC) (Individual Company) is a different entity type from
Egyéni Vállalkozó (EV). EC is registered in the Cégjegyzék and falls under the
Commercial Companies column.
Documents by Entity Type
Commercial Companies (Cégjegyzékszám)
The Cégmásolat is a historical record. It lists past register entries
with their validity periods. For a struck-off company, the profile does not
return its historical officers or owners as current data.
Sole Traders (Nyilvántartási szám)
No financial statements for sole traders. Sole traders keep simplified
records and do not file annual accounts, so
financialStatements is never
returned for an EVNY entity.Pricing
Pricing differs by entity type:- Commercial companies (OCCSZ): Variable pricing, based on the register’s quote for the Trade Register Extract of that company.
- Sole traders (EVNY): Fixed pricing.
Budget control. For commercial companies, because pricing is variable, the
profileMaxBudget parameter lets you set a maximum spend. The value is
denominated in the same units as the price field returned by the
available-documents call. Set the cap based on the quoted price you accept. If
the estimated cost exceeds your budget, the request fails immediately with a
budget_exceeded error that includes the quoted price, so you can retry with a
higher cap. For sole traders, budget control is not supported.Data Source Priority & Routing
For a given entity, data follows a deterministic retrieval path:Company Profile Resolution Flow:
- Price quote: The Trade Register Extract price for the company is quoted by the register
- Budget check: If
profileMaxBudgetis set, the resulting profile price is compared against the budget. The request is rejected withbudget_exceededif over budget - Extract: The Trade Register Extract is retrieved and read into structured data (name, address, legal form, capital, representatives, shareholders, activities, establishments, status), with the group VAT number added from NAV
- VIES VAT validation: A qualified VIES check validates the VAT number (HU + first 8 digits of tax number) and obtains a consultation number
tradeRegisterExtract document.Attribute-Level Source Mapping
Example API Responses
All examples use placeholder data. Query:POST /v2/company with { "id": "<id>", "countryCode": "HU", "dataPoints": ["company", "legalRepresentatives"] }
Active Kft. (Limited Liability Company)
Active Kft. (Limited Liability Company)
Struck-off Company
Struck-off Company
tradeRegisterHistory document. Companies that were in liquidation (“végelszámolás alatt”) before deletion retain that marker in their legal name.Active Sole Trader (Egyéni Vállalkozó)
Active Sole Trader (Egyéni Vállalkozó)
shareholders request returns datapoint_not_applicable. Activity codes use 6-digit TEÁOR codes from EVNY (vs 4-digit from OCCSZ TRE). Legal name includes the “e.v.” suffix (egyéni vállalkozó).Available Documents
Available Documents
Documents are returned when Note: Each document carries a
"dataPoints": ["availableDocuments"] is requested.price field, in credits, shown before purchase. The Trade Register Extract price varies per company.