{"openapi":"3.0.3","info":{"title":"Hungarian Business Document & Bank Account Validator API","version":"1.0.0","description":"Validates Hungarian Adószám (11-digit corporate tax ID), Adóazonosító jel (10-digit personal tax ID with birth-date decoding), Cégjegyzékszám (court & legal form), and 8-8 / 8-8-8 Giro bank accounts with HU IBAN conversion."},"servers":[{"url":"https://api.tinplate.dev","description":"Production Edge Gateway"}],"components":{"schemas":{"HuBusinessValidateResponseData":{"type":"object","properties":{"all_valid":{"type":"boolean","example":true},"adoszam":{"type":"object","nullable":true,"properties":{"valid":{"type":"boolean"},"normalized":{"type":"string"},"core_8":{"type":"string"},"eu_vat_number":{"type":"string","nullable":true},"vat_code":{"type":"string","nullable":true},"vat_code_meaning":{"type":"string","nullable":true},"county_code":{"type":"string","nullable":true},"county_name":{"type":"string","nullable":true},"checksum_valid":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}},"required":["valid","normalized","core_8","eu_vat_number","vat_code","vat_code_meaning","county_code","county_name","checksum_valid","errors"]},"adoazonosito_jel":{"type":"object","nullable":true,"properties":{"valid":{"type":"boolean"},"normalized":{"type":"string"},"birth_date_derived":{"type":"string","nullable":true},"errors":{"type":"array","items":{"type":"string"}}},"required":["valid","normalized","birth_date_derived","errors"]},"cegjegyzekszam":{"type":"object","nullable":true,"properties":{"valid":{"type":"boolean"},"normalized":{"type":"string"},"court_code":{"type":"string","nullable":true},"court_name":{"type":"string","nullable":true},"legal_form_code":{"type":"string","nullable":true},"legal_form_name":{"type":"string","nullable":true},"errors":{"type":"array","items":{"type":"string"}}},"required":["valid","normalized","court_code","court_name","legal_form_code","legal_form_name","errors"]},"bank_account":{"type":"object","nullable":true,"properties":{"valid":{"type":"boolean"},"giro_formatted":{"type":"string","nullable":true},"iban":{"type":"string","nullable":true},"iban_formatted":{"type":"string","nullable":true},"bank_code":{"type":"string","nullable":true},"bank_name":{"type":"string","nullable":true},"bic":{"type":"string","nullable":true},"branch_checksum_valid":{"type":"boolean"},"account_checksum_valid":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}},"required":["valid","giro_formatted","iban","iban_formatted","bank_code","bank_name","bic","branch_checksum_valid","account_checksum_valid","errors"]}},"required":["all_valid","adoszam","adoazonosito_jel","cegjegyzekszam","bank_account"]},"HuBusinessValidateRequest":{"type":"object","properties":{"adoszam":{"type":"string","maxLength":32,"example":"12345676-2-41","description":"11-digit Hungarian corporate tax number (XXXXXXXX-Y-ZZ)."},"adoazonosito_jel":{"type":"string","maxLength":32,"example":"8421567896","description":"10-digit Hungarian personal tax ID starting with 8."},"cegjegyzekszam":{"type":"string","maxLength":32,"example":"01-09-123456","description":"10-digit Hungarian company registration number (XX-YY-ZZZZZZ)."},"bank_account":{"type":"string","maxLength":64,"example":"11773016-11111018-00000000","description":"Hungarian Giro bank account (8-8 or 8-8-8 digits) or 28-character HU IBAN."}}},"ResponseMeta":{"type":"object","required":["request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"ms":{"type":"integer","minimum":0},"version":{"type":"string","example":"1.0.0"}}},"ErrorEnvelope":{"type":"object","required":["ok","error","meta"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"Request body failed validation"}}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}}},"parameters":{}},"paths":{"/v1/hu-business-validator":{"post":{"tags":["23_HU_BUSINESS_VALIDATOR"],"summary":"Validate Hungarian Adószám, Adóazonosító jel, Cégjegyzékszám, and Giro/IBAN bank accounts","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HuBusinessValidateRequest"}}}},"responses":{"200":{"description":"Detailed validation results and metadata for each provided Hungarian identifier","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/HuBusinessValidateResponseData"},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["ok","data","meta"]}}}},"400":{"description":"Invalid input or malformed JSON request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid authentication credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"413":{"description":"Request payload exceeds subscribed plan byte cap","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}}}