Hungary

Data Sources

All company data is sourced from the OCCSZ (Országos Cégnyilvántartó és Céginformációs Szolgálat — National Company Register and Company Information Service), which operates the official Hungarian company register. The system interacts with two distinct services:

Structured Search Data

OCCSZ XML API — A paid, authenticated XML API providing company search by name, registration number, and tax number. Returns structured XML with company name, registration number, address, tax number, and status. Used for all search operations and as the entry point for company identification.

Company Profile & Documents

Trade Register Extract (Cégkivonat) — A comprehensive PDF document purchased from the OCCSZ API for each company. This is the primary source for all structured company profile data. The PDF is parsed deterministically to extract: 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.

Company profile is derived from the Trade Register Extract. The TRE PDF is purchased from the OCCSZ API, then parsed deterministically. AI enrichment is applied in parallel for address parsing, legal form standardization (ISO 20275), and role classification.

Company Identifiers

Query Identifiers

Identifier	Source	Format	Example	Notes
Cégjegyzékszám (Registration number)	OCCSZ	10 digits (hyphens stripped)	`0109430929`	Primary company identifier. Hyphens accepted but removed internally (e.g., `01-09-430929` becomes `0109430929`)
Adószám (Tax number)	OCCSZ	8-11 digits (hyphens stripped)	`32565144241`	Full format: `XXXXXXXX-X-XX`. First 8 digits used for registry search
VAT	VIES	HU + 8 digits	`HU32565144`	Automatically stripped to 8-digit VAT value for VIES validation

Tax Number Format Breakdown: 32565144-2-41 = 32565144 (company serial number) + 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:

Identifier Type	Format	Example	Notes
`registrationNumber`	10 digits	`0109430929`	Always present. Hyphens stripped
`taxNumber`	Up to 13 characters	`32565144241`	Present when available in the TRE
`VAT`	8 digits	`32565144`	First 8 digits of tax number, present when tax number is available
`EUID`	Alphanumeric	`HUOCCSZ.0109430929`	European Unique Identifier, when available in the TRE (§60)

Search Capabilities

Search Type	Pattern	Example	Match Type	Expected Results
By Cégjegyzékszám	10 digits	`0109430929`	Exact	Single company (1 result)
By Adószám (8 digits)	8 digits	`32565144`	Exact	Single company (1 result)
By Adószám (11 digits)	11 digits	`32565144241`	Exact	Single company (first 8 digits used)
By Adószám (with hyphens)	`XXXXXXXX-X-XX`	`32565144-2-41`	Exact	Single company (hyphens stripped, first 8 digits used)
By VAT number	HU + 8 digits	`HU32565144`	Exact	Single company (HU prefix stripped, 8 digits extracted)
By company name	Text string	`"bolttech Services"`	Contains	Multiple results

Company Profile

For the companyProfile endpoint, the full 10-digit Cégjegyzékszám is required (hyphens will be stripped internally):

Correct: 0109430929, 0106216884, 01-09-430929
Incorrect: 01-06-2168, Nokia, 28383040-2-42

Company Status

Company status is determined deterministically from the Trade Register Extract — no AI inference is involved for status determination.

Status Logic

Status is determined in priority order from the Trade Register Extract:

Priority	Condition	Local Status	Standardized Status	Notes
1	§1 has “Törlés hatálya” (deletion date)	Törölve (reason)	Closed	Checked first — company was deleted from registry
2	Name contains “végelszámolás” in quotes	végelszámolás alatt	Closed	Voluntary dissolution in progress
3	Name contains “felszámolás” in quotes	felszámolás alatt	Under Insolvency Proceeding	Bankruptcy/insolvency proceedings
4	Name contains “kényszertörlés” in quotes	kényszertörlés alatt	Closed	Administrative dissolution in progress
5	Name contains “szerkezetátalakítás” in quotes	szerkezetátalakítás alatt	Active	Structural transformation (company remains active)
6	No closure markers	Hatályos	Active	Default — company is active

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:

Hungarian Deletion Method	Standardized Closure Reason
Contains “átalakulás” (transformation)	Merger
Contains “felszámolás” (liquidation)	Bankruptcy
Contains “kényszertörlés” (forced deletion)	Administrative Dissolution
Contains “végelszámolás” (voluntary winding)	Voluntary Dissolution
Any other method	Other

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

Abbr.	Hungarian Name	English Translation	Standardized
KFT	Korlátolt Felelősségű Társaság	Limited Liability Company	Limited Liability Company
BT	Betéti Társaság	Limited Partnership	Partnership
ZRT	Zártkörűen Működő Részvénytársaság	Private Limited Company	Corporation
NYRT	Nyilvánosan Működő Részvénytársaság	Public Limited Company	Corporation
KKT	Közkereseti Társaság	General Partnership	Partnership
EC	Egyéni Cég	Individual Company	Sole Proprietorship

Sole Entrepreneurs

Abbr.	Hungarian Name	Standardized
EV	Egyéni Vállalkozó	Sole Proprietorship

Foreign Entities

Abbr.	Hungarian Name	Standardized
FIL	Külföldi Vállalkozás Magyarországi Fióktelepe	Branch or Representative Office
—	Külföldi Székhelyű Vállalkozás Fióktelepe	Branch or Representative Office

Other Forms

Abbr.	Hungarian Name	Standardized
SZÖV	Szövetkezet	Cooperative
EGY	Egyesülés	Association
ALA	Alapítvány	Foundation
KHT	Közhasznú Társaság	Public Benefit Company

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 as “együttes” (joint) or “önálló” (individual)

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.

Legal Representative Roles

The following roles are deterministically mapped from Hungarian registry terminology — no AI is involved for these known roles:

Hungarian Role	English Translation	Standardized Role
ügyvezető	Managing Director	Managing Director
cégvezető	Company Manager	Managing Director
vezető tisztségviselő	Executive Officer	Managing Director
ügyvezető (vezető tisztségviselő)	Managing Director (Executive Officer)	Managing Director
vezérigazgató	CEO	CEO
igazgatósági tag	Board Member	Board Member
elnök	Chairman	Chairman
képviseletre jogosult tag	Member with Representation Rights	Other

Roles matching the table above are mapped deterministically (AI is skipped). For roles not matching any known pattern, AI provides the English translation and standardized classification. 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

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, which is the Hungarian adaptation of NACE Rev. 2. Activity codes are extracted from the TRE and mapped across three levels:

TEÁOR (Hungarian) → NACE Rev. 2 (European) → ISIC Rev. 4 (International)

Classification	Source	Example	AI Inferred?
TEÁOR	TRE (§902)	`6201`	No (official)
NACE	Derived from TEÁOR	`62.01`	No (deterministic conversion)
ISIC	Derived from NACE via mapping table	`6201`	No (deterministic)

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).

Data Availability Matrix

Data Type	Commercial Companies	Sole Entrepreneurs (EV)	Non-Profits / Foundations	Notes
Company Profile	✅ Async	❌	⚠️ Limited	Variable pricing: TRE cost + fixed fee
Legal Representatives	✅ (active only)	❌	⚠️ Limited	§13 of TRE, may be absent for closed companies
Other Key Persons	✅	❌	⚠️ Limited	Auditors (§14), Supervisory Board (§15) from TRE
Shareholders	⚠️	❌	❌	Part II of TRE, depends on company type
Ultimate Beneficial Owners	❌	❌	❌	Not available from registry
Activity Codes	✅	❌	❌	TEÁOR from TRE, converted to NACE + ISIC
Documents	✅ (Paid)	❌	❌	Trade Register Extract PDF, dynamic pricing
Establishments	✅	❌	❌	Business premises (§6) and branch offices (§7) from TRE

Legend: ✅ Available | ❌ Not Available | ⚠️ Conditionally Available | Async = Asynchronous processing

Sole Entrepreneurs (EV) are not registered in the Cégjegyzék (Company Register) managed by OCCSZ. They are registered in a separate system (Egyéni Vállalkozói Nyilvántartás) that is not covered by this integration. Egyéni Cég (EC) — Individual Company — is a different entity type that is registered in the Cégjegyzék and falls under the Commercial Companies column.

Documents by Company Type

Documents are retrieved from the OCCSZ XML API with dynamic pricing.

Commercial Companies (Cégjegyzékszám)

Document Type	API Category	Format	SKU	Availability	Notes
Cégkivonat (Trade Register Extract)	`tradeRegisterExtract`	PDF	`hun-register-extract`	✅ All companies	Dynamic pricing from OCCSZ API

Document prices are fetched in real-time from the OCCSZ API and displayed in the price field before purchase. Pricing is based on document size (kbyte-based billing) and may vary between companies.

TRE price is variable. Unlike flat-rate documents, the Trade Register Extract price depends on the document size. Larger companies with more historical data will have higher prices. The price is always shown before purchase.

Pricing

Company profile pricing for Hungary is variable — the total cost depends on the underlying Trade Register Extract price (which varies by company) plus a fixed profile fee.

Budget control. Because pricing is variable, the profileMaxBudget parameter lets you set a maximum spend (in credit cents). If the estimated cost exceeds your budget, the request fails with a budget_exceeded error that includes the quoted price, so you can retry with a higher budget.

Data Source Priority & Routing

For a given entity, data follows a deterministic retrieval path:

Company Profile Resolution Flow:

Search — Query the OCCSZ XML API by registration number to verify the company exists and obtain the tax number
Available Documents — Fetch the TRE price quote from OCCSZ
Budget check — If profileMaxBudget is set, compare the estimated cost (TRE with markup + fixed profile fee) against the budget. Reject with budget_exceeded if over budget
Download TRE — Purchase and download the Trade Register Extract PDF from OCCSZ
PDF → Markdown — Convert the PDF to structured markdown using PyMuPDF4LLM
Deterministic parsing — Parse the markdown to extract all structured data (name, address, legal form, capital, representatives, shareholders, activities, establishments, status)
AI enrichment (parallel) — Enrich in parallel: address parsing, legal form standardization (ISO 20275), currency parsing, role classification for legal representatives, establishment address parsing
VIES VAT validation — A qualified VIES check validates the VAT number (HU + first 8 digits of tax number) and obtains a consultation number

Document Resolution Flow:The Trade Register Extract PDF is purchased directly from the OCCSZ API. The price is fetched first, then the document is downloaded and stored. The same PDF used for company profile extraction is delivered as the document.

Attribute-Level Source Mapping

Attribute	Source	AI Enriched?	Notes
Legal name	TRE (§2)	No	Extracted deterministically from markdown
Registration number	TRE (§1 header)	No	Hyphens stripped
Tax number	OCCSZ search + TRE (§21)	No	From search result `internalIdentifiers` or TRE
Registered address	TRE (§5)	Yes	Parsed from Hungarian format, AI-enriched for structuring
Legal form	TRE (Cégforma field)	Yes	Deterministic extraction, AI-enriched for ISO 20275
Registration date	TRE (§8)	No	Founding date
Status	TRE (§1 + name)	No	Deterministic: §1 deletion date/reason checked first, then quoted status in name, then default active
Share capital	TRE (§11)	Partial	Amount and known currencies (HUF, EUR, USD, GBP, CHF) deterministic; AI fallback only for unrecognized currencies
Legal representatives	TRE (§13)	Partial	Deterministic extraction; known roles mapped deterministically, unknown roles AI-enriched
Auditors	TRE (§14)	No	Deterministic extraction
Supervisory board	TRE (§15)	No	Deterministic extraction
Shareholders	TRE (Part II)	No	Deterministic extraction when available
Activity codes (TEÁOR/NACE)	TRE (§902)	No	Deterministic extraction and conversion
Activity codes (ISIC)	TRE (§902)	No	Deterministic: NACE → ISIC via official UN correspondence table
Establishments	TRE (§6, §7)	Yes	Deterministic extraction, address AI-enriched
VAT verification	VIES	No	Qualified check with consultation number

Example API Responses

All examples use placeholder data. Query: POST /company with { "id": "<id>", "countryCode": "HU", "dataPoints": ["companyProfile"] }

Active Kft. (Limited Liability Company)

{
  "company": {
    "id": "0109430929",
    "countryCode": "HU",
    "identifiers": { "registrationNumber": "0109430929", "taxNumber": "32565144241", "VAT": "32565144" },
    "taxId": {
      "type": "eu_vat",
      "value": "32565144",
      "country": "HU",
      "verification": {
        "status": "verified",
        "verifiedName": "PELDA TECHNOLOGIA KFT",
        "consultationNumber": "WAPIXXXXXXXXXXXX"
      }
    },
    "legalName": "Példa Technológia Korlátolt Felelősségű Társaság",
    "registrationDate": "2024-05-28",
    "status": { "localName": "Aktív", "active": true, "statusDetails": { "status": "ACTIVE" } },
    "legalForm": { "localName": "Korlátolt Felelősségű Társaság", "englishTranslation": "Limited Liability Company", "standardized": "Limited Liability Company", "iso20275Code": "P9F2" },
    "capital": { "amount": 3100000, "currency": "HUF" },
    "activities": {
      "TEAOR": [{ "code": "6201", "description": "Számítógépes programozás", "isAIInferred": false }],
      "NACE": [{ "code": "62.01", "description": "Computer programming activities", "isAIInferred": false }],
      "ISIC": [{ "code": "6201", "description": "Computer programming activities", "isAIInferred": false }]
    },
    "legalAddress": { "addressLine1": "2 Ferenciek tere", "city": "Budapest", "postalCode": "1053", "countryCode": "HU" }
  },
  "legalRepresentatives": [
    {
      "type": "individual",
      "role": { "localName": "ügyvezető", "englishTranslation": "Managing Director", "standardized": "Managing Director" },
      "individual": {
        "name": { "fullName": "Nagy István", "firstName": "Nagy", "lastName": "István" },
        "birthDate": { "year": 1985, "month": 6, "day": 15 },
        "residenceAddress": { "addressLine1": "10 Andrássy út", "city": "Budapest", "postalCode": "1061", "countryCode": "HU" }
      },
      "startDate": "2024-05-28"
    }
  ]
}

Closed Bt. (Limited Partnership) — Voluntary Dissolution

{
  "company": {
    "id": "0106216884",
    "countryCode": "HU",
    "identifiers": { "registrationNumber": "0106216884", "taxNumber": "28383040242" },
    "legalName": "Példa Kereskedelmi Betéti Társaság \"végelszámolás alatt\"",
    "registrationDate": "1993-11-23",
    "status": {
      "localName": "Törölve (kérelemre)",
      "active": false,
      "statusDetails": { "status": "CLOSED", "closureReason": "VOLUNTARY_DISSOLUTION", "closureDate": "2017-01-06T00:00:00.000Z" }
    },
    "legalForm": { "localName": "Betéti Társaság", "englishTranslation": "Limited Partnership", "standardized": "Partnership", "iso20275Code": "S3DA" },
    "legalAddress": { "addressLine1": "121 Andrássy út", "city": "Budapest", "postalCode": "1062", "countryCode": "HU" }
  },
  "legalRepresentatives": []
}

Note: Closed companies have active: false and may have empty legal representatives. The closureDate is extracted from the TRE. Companies that were in liquidation (“végelszámolás alatt”) before deletion retain that marker in their legal name.

Available Documents

Documents are returned when "dataPoints": ["availableDocuments"] is requested.

API Category	Document	Notes
`tradeRegisterExtract`	Cégkivonat (Trade Register Extract) PDF	Dynamic pricing from OCCSZ. Available for all companies (active and closed)

{
  "documents": {
    "tradeRegisterExtract": {
      "id": "doc_abc123",
      "name": "Trade Register Extract",
      "description": "Trade register extract from the Hungarian Trade Register (Ministry of Justice)",
      "format": "pdf",
      "type": "tradeRegisterExtract",
      "price": {
        "amount": 2.27,
        "currency": "EUR"
      }
    }
  },
  "request": {
    "companyId": "0109430929",
    "countryCode": "HU",
    "dataStatus": {
      "dataPoints": {
        "availableDocuments": { "status": "succeeded" }
      }
    }
  }
}

Note: The price field reflects the real-time cost from the OCCSZ API. Prices are in EUR and vary based on document size.

Quirks & Gotchas

Quirk	Details
Hyphens in identifiers	Both Cégjegyzékszám and Adószám may contain hyphens (e.g., `01-09-430929`, `28383040-2-42`). These are stripped internally before processing.
Leading zeros in registration numbers	Registration numbers always have 10 digits. Numbers with leading zeros (e.g., `0109430929` — Budapest court code `01`) are preserved correctly.
Liquidation detected from company name	Companies in liquidation are identified by the presence of “végelszámolás alatt” or “v.a.” in the legal name, not from a dedicated status field.
TRE price is variable	Trade Register Extract pricing is kbyte-based. Larger companies (more history, more sections) cost more. Prices are always shown before purchase.
Company profile = TRE	The company profile is entirely derived from the Trade Register Extract PDF. Requesting a company profile will purchase and parse the TRE.
No shareholders for all company types	Part II (ownership section) is not present in all TRE documents. Availability depends on the company type and registry content.
No legal reps for closed companies	Section 13 (legal representatives) may be absent in TRE documents for closed companies.
Closure reason defaults to OTHER	When a company is closed (“Törölve”) and the deletion method doesn’t match a known pattern, the closure reason defaults to `OTHER`. Known patterns: átalakulás (Merger), felszámolás (Bankruptcy), kényszertörlés (Administrative Dissolution), végelszámolás (Voluntary Dissolution).
Tax number truncated to 13 digits	The tax number (Adószám) is truncated to 13 characters in the identifiers to standardize the format.
TEÁOR = NACE	Hungarian TEÁOR codes map 1:1 to NACE Rev. 2 codes (same numeric values, different formatting).
HUF to EUR conversion	Document prices are quoted in HUF by the OCCSZ API and converted to EUR for the API response.

Activity Mapping - NACE/ISIC classification system

Western Europe

Northern Europe

Southern Europe

Central & Eastern Europe

Crown Dependencies & Offshore

Asia & Indian Ocean

Data Sources

Structured Search Data

Company Profile & Documents

Company Identifiers

Query Identifiers

Identifiers in API Response

Search Capabilities

Company Profile

Company Status

Status Logic

Closure Reasons

Legal Forms

Key Business Forms

Sole Entrepreneurs

Foreign Entities

Other Forms

Legal Representatives

Extraction Details

Legal Representative Roles

Other Key Persons

Shareholders

Activity Code Mapping

Data Availability Matrix

Documents by Company Type

Commercial Companies (Cégjegyzékszám)

Pricing

Data Source Priority & Routing

Attribute-Level Source Mapping

Example API Responses

Quirks & Gotchas

Western Europe

Northern Europe

Southern Europe

Central & Eastern Europe

Crown Dependencies & Offshore

Asia & Indian Ocean

​Data Sources

​Structured Search Data

​Company Profile & Documents

​Company Identifiers

​Query Identifiers

​Identifiers in API Response

​Search Capabilities

​Company Profile

​Company Status

​Status Logic

​Closure Reasons

​Legal Forms

​Key Business Forms

​Sole Entrepreneurs

​Foreign Entities

​Other Forms

​Legal Representatives

​Extraction Details

​Legal Representative Roles

​Other Key Persons

​Shareholders

​Activity Code Mapping

​Data Availability Matrix

​Documents by Company Type

​Commercial Companies (Cégjegyzékszám)

​Pricing

​Data Source Priority & Routing

​Attribute-Level Source Mapping

​Example API Responses

​Quirks & Gotchas

Data Sources

Structured Search Data

Company Profile & Documents

Company Identifiers

Query Identifiers

Identifiers in API Response

Search Capabilities

Company Profile

Company Status

Status Logic

Closure Reasons

Legal Forms

Key Business Forms

Sole Entrepreneurs

Foreign Entities

Other Forms

Legal Representatives

Extraction Details

Legal Representative Roles

Other Key Persons

Shareholders

Activity Code Mapping

Data Availability Matrix

Documents by Company Type

Commercial Companies (Cégjegyzékszám)

Pricing

Data Source Priority & Routing

Attribute-Level Source Mapping

Example API Responses

Quirks & Gotchas