{
"source": "eu-vies-rest-and-gleif-lei-v1",
"vatCheck": {
"vat": "DE129274202",
"countryCode": "DE",
"vatNumber": "129274202",
"isValid": true,
"viesStatus": "ok",
"viesError": null,
"companyName": null,
"address": null,
"requestDate": "2026-11-21T06:50:58.176Z"
},
"leiCount": 0,
"leiRecords": []
}
curl --location --request GET 'https://zylalabs.com/api/15159/eu+vat+validation+vies+api/40440/verify+eu+vat+and+lookup+gleif+lei?vat=DE129274202' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 欧盟增值税验证系统 VIES API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
通过 EU VIES REST 实时验证欧洲增值税号,并通过 GLEIF v1 查询全球法人机构识别编码(LEI)
是的,增值税检查会查询欧盟委员会的 VIES REST API,LEI 记录会查询官方 GLEIF v1 API
`vatCheck` 对象包含已提交的 VAT 标识符、`countryCode`、标准化后的 `vatNumber`、布尔值 `isValid`、`viesStatus`、任何 `viesError`、可选的公司详细信息以及 `requestDate` 时间戳
完整标识符显示在 `vat` 中,而国家前缀和数字部分分别拆分到 `countryCode` 和 `vatNumber` 中。例如,`DE129274202` 会返回国家代码 `DE` 和号码 `129274202`
`isValid`表示提交的欧盟增值税号是否通过 VIES 验证请求被判定为有效。值为 `true` 表示验证成功;请查看 `viesStatus` 和 `viesError` 以了解更多信息。
该端点支持通过精确的 LEI 查询,也支持根据法人实体名称进行搜索。匹配结果会在 `leiRecords` 数组中返回,总数由 `leiCount` 报告
LEI 结果归集在顶层 `leiRecords` 数组下。`leiCount` 表示返回的记录数量。如果没有实体符合所提供的条件,API 将返回 `leiCount: 0` 和一个空的 `leiRecords` 数组.
空的 `leiRecords` 数组表示未找到与提供的 LEI 或法定名称搜索匹配的 GLEIF 记录。应用程序应将 `leiCount: 0` 视为有效的无匹配结果,而不是假设响应格式错误
是的。该端点可以同时提供 `vatCheck` 对象和 LEI 搜索结果。这使应用程序能够验证欧洲增值税号,同时检查是否存在相应的法人实体记录。
该端点返回一个结构化的 JSON 对象。其中包含一个 `source` 标识符、用于增值税验证的嵌套 `vatCheck` 对象,以及用于 LEI 结果的 `leiCount` 和 `leiRecords`。`companyName`、`address` 或 `viesError` 等可空字段在不可用时可能包含 `null`