Compliance & Business Tier 2 Ready POST /v1/hu-business-validator

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.

Try It Live in Your Browser · No API Key Required

1. Interactive Sandbox & Sample JSON Output

200 OK · Ready

Editable Request JSON (`POST /v1/hu-business-validator`)

Live 200 OK Response Envelope

{
  "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
  }
}

Get API Key on RapidAPI Get API Key on Zyla Hub Download OpenAPI 3.0.3 Spec

2. Quickstart Code Examples

Full TypeScript & Python SDK →

curl -X POST "https://api.tinplate.dev/v1/hu-business-validator" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -d '{"adoszam":"10337051-2-44","bank_account":"11773016-11111018-00000000"}'

import { TinplateClient } from "@tinplate/sdk"; // npm install @tinplate/sdk

const tinplate = new TinplateClient({
  rapidApiKey: process.env.RAPIDAPI_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",
        "X-RapidAPI-Key": "YOUR_RAPIDAPI_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",
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_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`)

Parameter	Type & Constraints	Description
`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`)

Field	Type	Description
`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'

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

4. Known Limitations & Test Verification

Release Version: v1.0.7 · Last Verified / Benchmarked: 14 November 2026 · Latency Note: Sub-millisecond figures measure in-Worker V8 compute time (typical client HTTPS network RTT to the nearest Cloudflare PoP is 15–65 ms) · See Full Portfolio Benchmarks & Corpora →

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

5. Marketplace Plans & Payload Quotas

Plan	Monthly Price	Included Requests	Rate Limit	Max Request Payload	Best For
BASIC	$0.00 / month	500 / month (hard limit)	10 req / min	64 KB	Evaluation, local development & CI smoke tests
PRO	$9.99 / month	15,000 / month	60 req / min	128 KB	Solo developers & production apps
ULTRA	$29.99 / month	100,000 / month	300 req / min	256 KB	Growing SaaS & multi-agent pipelines
MEGA	$79.99 / month	500,000 / month	1,000 req / min	256 KB	High-volume enterprise workloads

Subscribe on RapidAPI Subscribe on Zyla Hub Full Pricing Details

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

7. Data Handling, Privacy & Marketplace Proxy Disclosure

Stateless in-memory validation; zero retention.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled in configuration (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Payloads are processed strictly in volatile V8 memory and never logged or stored by Tinplate.

Marketplace Proxies vs. Direct Bearer Key: Requests sent via RapidAPI or Zyla API Hub pass through those marketplaces' proxy infrastructure (subject to their respective privacy policies). Security-sensitive workloads requiring end-to-end zero-intermediary processing can connect directly to https://api.tinplate.dev using a Direct Bearer Key (Authorization: Bearer <API_KEY>). Read our full Privacy Notice and OpenAPI 3.0.3 JSON Schema.