{
"count": 4,
"items": [
{
"input": "IE6388047V",
"country_code": "IE",
"country": "Ireland",
"vat_number": "6388047V",
"full_vat_number": "IE6388047V",
"status": "valid",
"valid": true,
"name": "GOOGLE IRELAND LIMITED",
"address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
"consultation_number": null,
"source": "EU VIES (European Commission)",
"error": null,
"source_checked_at": "2026-11-20T03:23:00.350Z",
"checked_at": "2026-11-20T03:23:00Z",
"response_ms": 327
},
{
"input": "DE811569869",
"country_code": "DE",
"country": "Germany",
"vat_number": "811569869",
"full_vat_number": "DE811569869",
"status": "valid",
"valid": true,
"name": null,
"address": null,
"consultation_number": null,
"source": "EU VIES (European Commission)",
"error": null,
"source_checked_at": "2026-11-20T03:23:02.902Z",
"note": "Germany does not share the company name/address through VIES; the number itself is valid",
"checked_at": "2026-11-20T03:23:02Z",
"response_ms": 2867
},
{
"input": "NO923609016MVA",
"country_code": "NO",
"country": "Norway",
"vat_number": "923609016",
"full_vat_number": "NO923609016",
"status": "valid",
"valid": true,
"name": "EQUINOR ASA",
"address": "Forusbeen 50, 4035 STAVANGER, Norge",
"consultation_number": null,
"source": "Bronnoysund Register Centre (Norway)",
"error": null,
"bankrupt": false,
"in_liquidation": false,
"checked_at": "2026-11-20T03:23:00Z",
"response_ms": 189
},
{
"input": "CHE-116.281.710 MWST",
"country_code": "CH",
"country": "Switzerland",
"vat_number": "116281710",
"full_vat_number": "CHE116281710",
"status": "valid",
"valid": true,
"name": "Groupe TVA, Nestlé S.A.",
"address": "Avenue Nestlé 55, 1800 Vevey, Switzerland",
"consultation_number": null,
"source": "Swiss Federal UID register",
"error": null,
"checked_at": "2026-11-20T03:23:00Z",
"response_ms": 821
}
]
}
curl --location --request GET 'https://zylalabs.com/api/15101/vat+validation+eu+vies+norway+switzerland+api/40143/vat+validation+api?vatNumbers=IE6388047V,DE811569869,NO923609016MVA,CHE-116.281.710 MWST' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 增值税验证 欧盟 VIES 挪威 瑞士 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
在官方注册表上每次调用验证多达100个增值税号码:欧盟VIES,27个国家+ XI,挪威和瑞士。名称,地址,VIES咨询编号用于审计。注册表故障显示不可用,绝不会出现错误的无效。
在官方注册上每次调用最多验证100个增值税号码:欧盟VIES(27个国家+XI),挪威和瑞士。名称、地址、用于审计的VIES咨询编号。注册中断表示不可用,绝不会是虚假的无效
每个请求最多100个结果,具体取决于端点
每个请求从公共来源收集实时数据 相同的请求可以从缓存中提供最多6小时
列表参数接受多个用逗号分隔的值,例如:伦敦,巴黎
该端点返回包含顶层 `count` 和 `items` 数组的 JSON。每个条目代表一个已提交的 VAT 号码,并包含其验证结果、识别信息、来源信息、时间戳和响应时间
每个结果可以包含 `input`、`country_code`、`country`、`vat_number`、`full_vat_number`、`status`、`valid`、`name`、`address`、`consultation_number`、`source`、`error`、`source_checked_at`、`checked_at` 和 `response_ms`人人操
`status` 提供结果类别,例如 `valid`,而 `valid` 是适用于程序化检查的布尔值。有效记录通常包含 `status: "valid"` 和 `valid: true`。无法确认某个数字时,请检查 `error` 和来源是否可用。
该 API 会将增值税号与欧盟 27 个成员国及 XI 的欧盟 VIES 数据进行核验,同时也会查询挪威和瑞士的官方登记信息。响应通过 `country_code` 和 `country` 标识适用的国家
`input` 保留提交的值,而 `vat_number` 包含国家/地区特定的号码,`full_vat_number` 则将国家/地区前缀与该号码组合起来,例如 `IE6388047V`。这使您可以将结果与请求进行匹配,并使用规范化的标识符。
无法访问的注册信息应报告为无法访问,而不是被错误地标记为无效。应用程序应检查 `status`、`valid` 和 `error`,并在采取操作前区分无法查询与已确认无效的增值税号
`source` 字段用于标识所使用的注册机构,例如 `EU VIES(欧盟委员会)`。如果提供了 `consultation_number`,则可用于审计记录。`source_checked_at` 记录查询来源的时间,而 `checked_at` 记录 API 处理结果的时间.
使用结果验证客户或供应商的增值税号,支持税务文件处理,匹配法人实体名称和地址,并保留咨询详情以供审计。单独处理每个 `items` 条目,因为一个批次可能包含有效、无效或不可用的混合结果】【。