Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
Compliance & Business Tier 2 All-Access

Hungarian Adószám, Cégjegyzékszám & NAV Invoice Validator API

Validate Hungarian adószám, cégjegyzékszám, GIRO bank accounts, and NAV invoice rules. Validate Hungarian tax numbers (adószám), company registry numbers (cégjegyzékszám), GIRO 2×8/3×8 bank accounts, TAJ/adóazonosító jel, and NAV Online Számla rules.

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/hu-business-validatorinput
200 OK sample / live responsejson
{
  "ok": true,
  "data": {
    "all_valid": true,
    "adoszam": {
      "valid": true,
      "normalized": "10337051-2-44",
      "core_8": "10337051",
      "eu_vat_number": "HU10337051",
      "vat_code": "2",
      "vat_code_meaning": "Általános szabályok szerint adózó (Standard VAT taxpayer)",
      "county_code": "44",
      "county_name": "Különös hatáskörű / Dél-pesti Igazgatóság",
      "checksum_valid": true,
      "errors": []
    },
    "adoazonosito_jel": null,
    "cegjegyzekszam": null,
    "bank_account": {
      "valid": true,
      "giro_formatted": "11773016-11111018-00000000",
      "iban": "HU42117730161111101800000000",
      "iban_formatted": "HU42 1177 3016 1111 1018 0000 0000",
      "bank_code": "117",
      "bank_name": "OTP Bank Nyrt.",
      "bic": "OTPVHUHB",
      "branch_checksum_valid": true,
      "account_checksum_valid": true,
      "errors": []
    }
  },
  "meta": {
    "request_id": "req_hu_01",
    "ms": 1
  }
}
OpenAPI 3.0.3 Get All-Access Key ($29/mo) No signup. No payload storage.
Quickstart Code Examples
curl -X POST "https://api.tinplate.dev/v1/hu-business-validator" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_KEY" \
  -d '{"adoszam":"10337051-2-44","bank_account":"11773016-11111018-00000000"}'
import { TinplateClient } from "@tinplate/sdk";

const tinplate = new TinplateClient({
  apiKey: process.env.TINPLATE_API_KEY!,
});

const { data, meta } = await tinplate.call("/v1/hu-business-validator", {
  "adoszam": "10337051-2-44",
  "bank_account": "11773016-11111018-00000000"
});
console.log(`[${meta.ms} ms]`, data);
import requests

response = requests.post(
    "https://api.tinplate.dev/v1/hu-business-validator",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_TINPLATE_KEY",
    },
    json={
  "adoszam": "10337051-2-44",
  "bank_account": "11773016-11111018-00000000"
}
)
print(response.json())
const response = await fetch("https://api.tinplate.dev/v1/hu-business-validator", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TINPLATE_KEY",
  },
  body: JSON.stringify({
  "adoszam": "10337051-2-44",
  "bank_account": "11773016-11111018-00000000"
}),
});
const result = await response.json();
console.log(result);
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_hu_business_validator",
    "arguments": {
      "adoszam": "10337051-2-44",
      "bank_account": "11773016-11111018-00000000"
    }
  }
}
OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (POST /v1/hu-business-validator)

ParameterType & ConstraintsDescription
adoszam optional string
maxLen: 32
11-digit Hungarian corporate tax number (XXXXXXXX-Y-ZZ).
adoazonosito_jel optional string
maxLen: 32
10-digit Hungarian personal tax ID starting with 8.
cegjegyzekszam optional string
maxLen: 32
10-digit Hungarian company registration number (XX-YY-ZZZZZZ).
bank_account optional string
maxLen: 64
Hungarian Giro bank account (8-8 or 8-8-8 digits) or 28-character HU IBAN.

Response data Object Fields (200 OK)

FieldTypeDescription
all_valid boolean Field 'all_valid'
adoszam object | null Field 'adoszam'
adoazonosito_jel object | null Field 'adoazonosito_jel'
cegjegyzekszam object | null Field 'cegjegyzekszam'
bank_account object | null Field 'bank_account'

What Hungarian Business Document & NAV Validator API Detects & Validates

  • Adószám (8-1-2 format): Modulo-10 weights [9,7,3,1] check digit, ÁFA code (1–5), and NAV territorial code (02–51)
  • Cégjegyzékszám (XX-YY-ZZZZZZ): court code (01–20), legal form code (01–23, e.g. 09 = Kft., 10 = Zrt.)
  • Hungarian GIRO bank account (16 or 24 digits): domestic check-digit validation, bank branch identification, and HU IBAN conversion
  • Adóazonosító jel (10-digit personal tax ID with birth-date epoch derivation) and TAJ szám (9-digit social security number)
Honest Engineering Boundaries

Known Limitations & Test Verification

Release: v1.0.39 · Verified: 16 November 2026 · Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) · See Full Portfolio Benchmarks →

  • Deterministic checksum and structural validator; does not query live NAV Online Számla XML credentials.
  • Tested v1.0.4 (14 November 2026).

Direct All-Access & Marketplace Plans

Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev: Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).

PlanMonthly PriceIncluded RequestsRate LimitMax PayloadBest For
BASIC$0.00 / mo500 / month10 req / min64 KBEvaluation & CI smoke tests
PRO$9.99 / mo15,000 / month60 req / min128 KBSolo devs & production apps
ULTRA$29.99 / mo100,000 / month300 req / min256 KBGrowing SaaS & multi-agent pipelines
MEGA$79.99 / mo500,000 / month1,000 req / min256 KBHigh-volume enterprise workloads

Frequently Asked Questions

Can it convert a domestic Hungarian 2×8 or 3×8 bank account number into an IBAN?

Yes, it validates the domestic GIRO check digits, identifies the Hungarian bank (OTP, MBH, K&H, Erste, Raiffeisen, etc.), and computes the exact 28-character HU IBAN.

Does it decode the ÁFA (VAT) status and county from an adószám?

Yes, the 9th digit is decoded into the NAV VAT status (e.g. 1 = alanyi adómentes, 2 = ÁFA körös, 5 = csoportos) and the last 2 digits into the county/directorate.

Does it pair with Hungarian bridge-day holiday calculations?

Yes, combine it with POST /v1/workday-holiday which includes official Hungarian ledolgozós Saturday workdays and 4-day bridge weekends.

Zero Payload Logging

Data Handling, Privacy & Proxy Disclosure

Stateless in-memory validation; zero retention.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.

Related Tinplate APIs

POST /v1/eu-vat-iban/iban Live

EU VAT & IBAN/BIC Validator API

Validate IBANs, BIC/SWIFT codes, and EU/UK VAT numbers with live EU VIES lookup.

POST /v1/workday-holiday/between Compliance & Business

Workday & Holiday Calculator API

Calculate business days and SLA deadlines across 30+ countries including HU swap Saturdays.

POST /v1/invoice-validator Tier 1

Invoice & EU EN 16931 / Peppol Validator API

Audit extracted invoices for line-item math errors, VAT mismatches, and Peppol compliance.