{
"request_id": "a4cb6aeb4c9c5f97",
"iban": {
"input": "DE89370400440532013000",
"valid": true,
"iban": "DE89370400440532013000",
"iban_formatted": "DE89 3704 0044 0532 0130 00",
"country_code": "DE",
"check_digits": "89",
"bban": "370400440532013000",
"bank_code": "37040044",
"branch_code": null,
"account_number": "0532013000",
"sepa": true,
"bank": {
"bic": "COBADEFFXXX",
"name": "Commerzbank Köln"
},
"source": "offline",
"error": null,
"cached": true
},
"billable": false,
"usage": {
"plan": "zyla",
"used": 2,
"limit": null,
"remaining": null,
"reset_at": "2026-11-01T00:00:00.000Z",
"note": "Quota and billing for Zyla API Hub subscriptions are managed by Zyla API Hub, the marketplace you subscribed through."
}
}
curl --location --request POST 'https://zylalabs.com/api/14335/eu+vat+and+iban+validation+api/35930/validate+vat+and+iban' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"iban":"DE89370400440532013000"}'
{
"plan": "zyla",
"plan_name": "Zyla API Hub",
"price_usd_per_month": 0,
"monthly_quota": null,
"used": 2,
"remaining": null,
"period_start": "2026-10-01T00:00:00.000Z",
"reset_at": "2026-11-01T00:00:00.000Z",
"rate_limit_per_minute": 600,
"requests_this_month": 7,
"key_id": null,
"marketplace": "zyla",
"note": "Quota and billing for Zyla API Hub subscriptions are managed by Zyla API Hub, the marketplace you subscribed through."
}
curl --location --request GET 'https://zylalabs.com/api/14335/eu+vat+and+iban+validation+api/35931/usage+and+plan+status' --header 'Authorization: Bearer YOUR_API_KEY'
{
"ok": true,
"service": "vat-iban-api",
"time": "2026-10-18T23:45:55.174Z"
}
curl --location --request GET 'https://zylalabs.com/api/14335/eu+vat+and+iban+validation+api/35932/health+check' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 欧盟增值税和国际银行帐号验证 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
验证增值税和国际银行账号接口返回欧盟增值税号码和国际银行账号的验证结果,包括有效性状态、格式化的国际银行账号、国家代码、银行详细信息以及相关的错误信息 使用和计划状态接口提供当前计划和使用指标的信息,而健康检查接口指示服务状态和版本
关键字段包括“有效”(指示有效性)“iban_formatted”(格式化的IBAN)“country_code”(IBAN的国家代码)“bank”(包含BIC和银行名称)以及“错误”(任何验证错误)使用端点包括“已使用”(已拨打的电话)和“重置时间”(下次重置日期)
返回的数据采用JSON格式结构化。每个响应包含嵌套对象,如"iban"用于IBAN详细信息和"usage"用于计划信息。这种结构化格式便于解析和集成到应用程序中
验证增值税和国际银行账户号码的端点提供增值税号码和国际银行账户号码的验证结果,包括可用的公司详情 使用端点提供API使用情况的见解 而健康检查端点确认服务的可用性和状态
发送一个带有JSON内容的POST请求,内容包含“vat”(带有两个字母国家前缀的欧盟增值税号,例如DE123456789;对于北爱尔兰使用XI)和/或“iban”(例如{"iban":"DE89370400440532013000"})。您可以在一个请求中传递一个或两个字段
响应数据被组织为主要对象,如“iban”用于IBAN验证结果和“usage”用于API使用指标。每个对象包含相关字段,使访问特定信息如有效性和银行详细信息变得容易
增值税数据来自欧盟的增值税信息交换系统VIES,覆盖所有27个欧盟成员国以及北爱尔兰(XI);公司名称/地址在成员国提供时返回。结果缓存24小时,在VIES停机期间使用最近的有效结果(或者有效:null并提示重试)。IBANs被验证。
典型用例包括验证增值税号码的有效性以进行开票确保遵守税收法规以及验证国际银行账号以进行安全金融交易这帮助企业避免账单和付款中的错误
Valid:null意味着该成员国的上游VIES服务不可用,且没有可供备用的缓存(最后已知有效)结果。响应包含重试提示;请稍后重试。这不是一个失败的请求,也不意味着VAT号码无效
尚未通过HMRC进行英国(GB)增值税验证即将推出北爱尔兰(XI)增值税号码已经通过VIES得到支持以及所有27个欧盟成员国