> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Hungary

> Country-specific identifiers, data sources, and implementation details

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

<Card title="Hungary coverage, pricing, and sources" icon="arrow-up-right-from-square" href="https://topograph.co/pricing/hu">
  Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
</Card>

<Note>
  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.
</Note>

## Data Sources

Hungary uses **two distinct registries** depending on the entity type:

### 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):

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

* **Trade Register Extract (Cégkivonat)**: A comprehensive PDF document retrieved 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.

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

### 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 Web API**: A JSON API behind reCAPTCHA, providing search by registration number (Nyilvántartási szám, 8 digits) or tax number (Adószám, 8 digits). Returns structured JSON with the trader's name, address, activity codes, status, and registration dates.

* **EVNY Extract**: A screenshot-based PDF of the EVNY registry page, available as a document for sole traders.

<Note>
  **Sole trader profiles are fully deterministic, no AI needed.** The EVNY API
  returns structured JSON, so all data is mapped directly to domain objects
  without any AI enrichment (except address geocoding).
</Note>

### 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ó). Access is free and public.

* **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 at no charge. When the filed document is a PDF or XML, the balance sheet and income statement are also extracted into structured `extractedFinancialData`.

<Note>
  **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.
</Note>

## 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`) |
| **Nyilvántartási szám** (Sole trader reg. number) | EVNY   | 8 digits                       | `57478665`    | Primary sole trader identifier. Automatically routes to EVNY                                                    |
| **Adószám** (Tax number)                          | Both   | 8-11 digits (hyphens stripped) | `32565144241` | Full format: `XXXXXXXX-X-XX`. First 8 digits used for registry search. Searches both OCCSZ and EVNY             |
| **VAT**                                           | VIES   | HU + 8 digits                  | `HU32565144`  | Automatically stripped to 8-digit VAT value for VIES validation                                                 |

<Tip>
  **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)
</Tip>

### 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)                                                        |
| `vatGroupNumber`     | `XXXXXXXX-X-XX`     | `17783666-5-41`      | Group VAT number (Csoportos adószám), present when the company is part of a Hungarian VAT group. Sourced from NAV. |

## Search Capabilities

| Search Type               | Pattern         | Example               | Match Type | Expected Results                                                                                             |
| ------------------------- | --------------- | --------------------- | ---------- | ------------------------------------------------------------------------------------------------------------ |
| By Cégjegyzékszám         | 10 digits       | `0109430929`          | Exact      | Exact match returned first (matchType: id); other results may follow                                         |
| By Nyilvántartási szám    | 8 digits        | `57478665`            | Exact      | Exact match returned first (matchType: id, from EVNY); other results may follow                              |
| By Adószám (8 digits)     | 8 digits        | `32565144`            | Exact      | Company and/or sole trader (searches both OCCSZ and EVNY in parallel)                                        |
| By Adószám (11 digits)    | 11 digits       | `32565144241`         | Exact      | Exact match returned first (matchType: id, first 8 digits used); other results may follow                    |
| By Adószám (with hyphens) | `XXXXXXXX-X-XX` | `32565144-2-41`       | Exact      | Exact match returned first (matchType: id, hyphens stripped, first 8 digits used); other results may follow  |
| By VAT number             | HU + 8 digits   | `HU32565144`          | Exact      | Exact match returned first (matchType: id, HU prefix stripped, 8 digits extracted); other results may follow |
| By company name           | Text string     | `"bolttech Services"` | Contains   | Multiple results (OCCSZ only; EVNY does not support name search)                                             |

<Note>
  **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.
</Note>

### 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`

## 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                       |

### Sole Trader Status (EVNY)

Sole trader status is determined from the EVNY API's structured fields:

| Condition                       | Local Status   | `active` | Standardized Status         | Notes                                                                                                                             |
| ------------------------------- | -------------- | -------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `vallalkozasAllapot` = "Működő" | Működő         | `true`   | Active                      | Normal operating trader                                                                                                           |
| `szuneteltetes` present         | Szünetelő      | `false`  | Active (dormant)            | Voluntary dormancy (up to 2 years). Entity still legally exists but is not trading. `additionalInfo` contains dormancy start date |
| `felfuggesztes` present         | Felfüggesztett | `false`  | Under Insolvency Proceeding | Suspended by NAV (tax authority). `additionalInfo` contains reason and dates                                                      |
| In `vallalkozasMegszunt` array  | Megszűnt       | `false`  | Closed                      | Terminated. Closure reason and date when available                                                                                |

## 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 |

<Note>
  Legal form standardization and ISO 20275 assignment are AI-enriched; the local
  Hungarian legal form name is always preserved verbatim from the TRE.
</Note>

## 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 `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

<Warning>
  **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.
</Warning>

### 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             |

<Note>
  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`.
</Note>

## 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

<Note>
  Shareholder data availability depends on the company type and the TRE content.
  Not all company types include Part II (ownership section) in their TRE.
</Note>

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

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

## Data Availability Matrix

| Data Type                  | Commercial Companies (OCCSZ) | Sole Traders (EVNY)    | Non-Profits / Foundations | Notes                                                                       |
| -------------------------- | ---------------------------- | ---------------------- | ------------------------- | --------------------------------------------------------------------------- |
| Company Profile            | ✅ Async                      | ✅ Async                | ⚠️ Limited                | Companies: variable pricing. Sole traders: fixed price only                 |
| Legal Representatives      | ✅ (active only)              | ✅ (owner as legal rep) | ⚠️ Limited                | OCCSZ: §13 of TRE. EVNY: owner mapped as Sole Proprietor                    |
| Other Key Persons          | ✅                            | ❌                      | ⚠️ Limited                | Auditors (§14), Supervisory Board (§15) from TRE                            |
| Shareholders               | ⚠️                           | ✅ (100% owner)         | ❌                         | OCCSZ: Part II of TRE. EVNY: owner = 100% shareholder                       |
| Ultimate Beneficial Owners | ❌                            | ❌                      | ❌                         | Not available from registry                                                 |
| Activity Codes             | ✅                            | ✅                      | ❌                         | TEÁOR from TRE/EVNY, converted to NACE + ISIC                               |
| Documents                  | ✅ (Paid)                     | ✅ (Free)               | ❌                         | OCCSZ: TRE PDF, dynamic pricing. EVNY: screenshot PDF, free                 |
| Financial Statements       | ✅ (Free)                     | ❌                      | ❌                         | Annual accounts from e-beszámoló. Companies only — sole traders do not file |
| Establishments             | ✅                            | ✅                      | ❌                         | OCCSZ: §6/§7 from TRE. EVNY: telephely addresses                            |

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

<Note>
  **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.
</Note>

## Documents by Entity Type

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

| Document Type                             | API Category           | Format          | Catalog item              | Availability                 | Notes                          |
| ----------------------------------------- | ---------------------- | --------------- | ------------------------- | ---------------------------- | ------------------------------ |
| **Cégkivonat (Trade Register Extract)**   | `tradeRegisterExtract` | PDF             | `hun-register-extract`    | ✅ All companies              | Dynamic pricing from OCCSZ API |
| **Éves beszámoló (Financial Statements)** | `financialStatements`  | PDF / XML / ZIP | `hun-financial-statement` | ✅ Companies, per fiscal year | Free, from e-beszámoló         |

### Sole Traders (Nyilvántartási szám)

| Document Type    | API Category           | Format | Catalog item | Availability       | Notes                       |
| ---------------- | ---------------------- | ------ | ------------ | ------------------ | --------------------------- |
| **EVNY Extract** | `tradeRegisterExtract` | PDF    | -            | ✅ All sole traders | Free, included with profile |

<Note>
  **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.
</Note>

<Note>
  **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.
</Note>

<Warning>
  **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.
</Warning>

## Pricing

Pricing differs by entity type:

* **Commercial companies (OCCSZ)**: **Variable** pricing. The total cost depends on the quoted Trade Register Extract price (which varies by company) plus a fixed processing fee.
* **Sole traders (EVNY)**: **Fixed** pricing. Only the fixed processing fee applies. The EVNY data source is free.

<Note>
  **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.
</Note>

## Data Source Priority & Routing

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

<Note>
  **Company Profile Resolution Flow:**

  1. **Search**: Query the OCCSZ XML API by registration number to verify the company exists and obtain the tax number
  2. **Available Documents**: Fetch the TRE price quote from OCCSZ
  3. **Budget check**: If `profileMaxBudget` is set, compare the estimated cost (the quoted Trade Register Extract price plus a fixed processing fee) against the budget. Reject with `budget_exceeded` if over budget
  4. **Download TRE**: Retrieval and download the Trade Register Extract PDF from OCCSZ
  5. **PDF to Markdown**: Convert the PDF to structured markdown using PyMuPDF4LLM
  6. **Deterministic parsing**: Parse the markdown to extract all structured data (name, address, legal form, capital, representatives, shareholders, activities, establishments, status)
  7. **AI enrichment (parallel)**: Enrich in parallel: address parsing, legal form standardization (ISO 20275), currency parsing, role classification for legal representatives, establishment address parsing, and NAV group VAT lookup
  8. **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 retrieved 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.
</Note>

### 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                                                                                      |
| Group VAT number            | **NAV** (csoportos\_afaalanyok)  | No           | Sourced from the NAV Group VAT registry when the company is part of a Hungarian VAT group. Present in `identifiers.vatGroupNumber` |
| VAT verification            | **VIES**                         | No           | Qualified check with consultation number                                                                                           |

## Example API Responses

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

<AccordionGroup>
  <Accordion title="Active Kft. (Limited Liability Company)">
    ```json theme={null}
    {
      "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" },
          "representationMode": { "mode": "sole" },
          "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"
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="Closed Bt. (Limited Partnership), Voluntary Dissolution">
    ```json theme={null}
    {
      "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.
  </Accordion>

  <Accordion title="Active Sole Trader (Egyéni Vállalkozó)">
    ```json theme={null}
    {
      "company": {
        "id": "57478665",
        "countryCode": "HU",
        "identifiers": { "registrationNumber": "57478665", "taxNumber": "59443494129", "VAT": "59443494" },
        "taxId": {
          "type": "eu_vat",
          "value": "59443494",
          "country": "HU",
          "verification": { "status": "verified", "verifiedName": "KOVÁCS ÁDÁM" }
        },
        "legalName": "KOVÁCS ÁDÁM e.v.",
        "registrationDate": "2022-09-01",
        "activityDescription": "Reklámfelület ügynöki értékesítése",
        "status": { "localName": "Működő", "active": true, "statusDetails": { "status": "ACTIVE" } },
        "legalForm": { "localName": "Egyéni vállalkozó", "englishTranslation": "Sole Proprietorship", "standardized": "Sole Proprietorship" },
        "activities": {
          "TEÁOR": [{ "code": "731201", "description": "Reklámfelület ügynöki értékesítése" }],
          "NACE": [{ "code": "73.12", "description": "Media representation" }],
          "ISIC": [{ "code": "7310", "description": "Media representation" }]
        },
        "legalAddress": { "addressLine1": "VINCELLÉR UTCA 2 10 em. 87 ajtó", "city": "DEBRECEN", "postalCode": "4031", "countryCode": "HU" }
      },
      "legalRepresentatives": [
        {
          "type": "individual",
          "role": { "localName": "Egyéni vállalkozó", "englishTranslation": "Sole Proprietor", "standardized": "Owner" },
          "individual": { "name": { "fullName": "KOVÁCS ÁDÁM", "firstName": "ÁDÁM", "lastName": "KOVÁCS" } }
        }
      ],
      "shareholders": [
        {
          "type": "individual",
          "sharePercentage": 100,
          "individual": { "name": { "fullName": "KOVÁCS ÁDÁM", "firstName": "ÁDÁM", "lastName": "KOVÁCS" } }
        }
      ]
    }
    ```

    **Note:** Sole traders always have exactly one legal representative (the owner, role "Sole Proprietor") and one 100% shareholder. 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ó).
  </Accordion>

  <Accordion title="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) |
    | `financialStatements`  | Éves beszámoló (Financial Statements), one entry per published fiscal year | Free, retrieved from e-beszámoló. Companies only                            |

    ```json theme={null}
    {
      "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.
  </Accordion>
</AccordionGroup>

## 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 retrieve 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.                                                                                                                                                                                                |
| **Group VAT number not in the Trade Register** | The Csoportos adószám is not published in the Cégkivonat. It is sourced separately from NAV and may not be present for all companies. Both the regular tax number and the group tax number must appear on invoices when a company is part of a VAT group.                              |
| **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.                                                                                                                                                                                          |
| **8-digit IDs are ambiguous**                  | A pure 8-digit input could be a sole trader registration number or a tax number. Both OCCSZ and EVNY are searched in parallel, with deduplication.                                                                                                                                     |
| **Sole traders use 6-digit TEÁOR codes**       | EVNY provides 6-digit TEÁOR codes (e.g., `731201`) vs. 4-digit from OCCSZ TRE (e.g., `7312`). The first 4 digits are identical and map to the same NACE/ISIC codes.                                                                                                                    |
| **EVNY name search not supported**             | The EVNY API does not support name-based search. Only registration number and tax number queries are available for sole traders.                                                                                                                                                       |