Skip to main content
This guide is outdated and will be removed on 1 November 2026. The up-to-date Hungary reference is on the Hungary country page.

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.
Ownership percentages are often absent. Hungarian extracts state member participation in words rather than as a figure. “A szavazati jog mértéke minősített többségű befolyást biztosít” means the voting right confers qualified-majority influence, at least 75%. Where the register publishes no capital contribution per member, sharePercentage is omitted rather than derived from that wording, so treat it as optional. Shareholders are still returned with their identity. This applies to both modes.

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

Tax Number Format Breakdown: 32565144-2-41 = 32565144 (base number, the last digit a check digit) + 2 (VAT status: 1=VAT free, 2=normal VAT, 4/5=group taxpayers) + 41 (tax office code)

Identifiers in API Response

Once you retrieve company data, the identifiers object contains all available identifiers for that entity: 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, so activeOnly=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: 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 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 representationMode field 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 representatives are only available for active companies. Closed companies use a minimal TRE format that may not include Section 13. This is a register limitation.
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.
A source entry explicitly stating that representation is not exercised is also a key person. 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-explicit TEAOR_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.
TRE price is variable. Unlike flat-rate documents, the Trade Register Extract price depends on the register’s quote for that company. Larger companies with more register history have higher prices. The price is always shown in the price field before purchase.

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.
See the pricing page for current prices. Financial statements and the EVNY extract are billed per document.
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:
  1. Price quote: The Trade Register Extract price for the company is quoted by the register
  2. Budget check: If profileMaxBudget is set, the resulting profile price is compared against the budget. The request is rejected with budget_exceeded if over budget
  3. 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
  4. VIES VAT validation: A qualified VIES check validates the VAT number (HU + first 8 digits of tax number) and obtains a consultation number
The same extract used for the company profile is delivered as the 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"] }
Note: When the register no longer issues a current extract for a struck-off company, the profile returns only the legal name, identifiers and a closed status. Person datapoints are empty, and the historical register copy (Cégmásolat) is delivered as the tradeRegisterHistory document. Companies that were in liquidation (“végelszámolás alatt”) before deletion retain that marker in their legal name.
Note: Sole traders always have exactly one legal representative (the owner, role “Sole Proprietor”). A sole trader has no share capital, so a 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ó).
Documents are returned when "dataPoints": ["availableDocuments"] is requested.
Note: Each document carries a price field, in credits, shown before purchase. The Trade Register Extract price varies per company.

Quirks & Gotchas