{
"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/15160/gleif+lei+entity+verification+api/40441/verify+eu+vat+and+lookup+gleif+lei?vat=DE129274202' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 GLEIF LEI 实体验证 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
通过 EU VIES REST 实时验证欧洲增值税号,并通过 GLEIF v1 查询全球法人机构识别码(LEI)
是的,增值税核查会查询欧盟委员会 VIES REST API,LEI 记录会查询官方 GLEIF v1 API。
该端点可以返回实时的欧盟增值税号验证结果和/或 GLEIF LEI 搜索结果。增值税号输出描述所提交的号码及其验证状态。LEI 输出包含通过 LEI 或法定名称找到的匹配法人实体记录。
VAT 验证涵盖 VIES 支持的欧盟成员国增值税号。LEI 查询涵盖 GLEIF 记录中全球注册的法人实体识别编码。VAT 响应会将国家代码与国家增值税号分开,例如“DE”和“129274202”
请求可以使用欧盟增值税号进行 VIES 验证,也可以通过 LEI 或法人实体名称搜索 GLEIF。请根据所需操作使用相应的输入;响应会指明返回了哪些结果集。
JSON 响应包含一个来源标识符、一个 `vatCheck` 对象、`leiCount` 和 `leiRecords`。`vatCheck` 包含增值税详情,而 `leiRecords` 包含匹配的 GLEIF 实体。`leiCount` 报告返回的 LEI 记录数量。
`vat` 是提交的标识符,`countryCode` 是其两字母国家前缀,`vatNumber` 是其国家部分。`isValid` 是验证结果,`viesStatus` 描述检查结果,`viesError` 在适用时包含错误。`requestDate` 记录请求时间戳。
当 VIES 返回时,`companyName` 和 `address` 可能包含注册信息。即使 `isValid` 为 `true`,它们也可能为 `null`,因此应用程序应根据 `isValid` 判断有效性,并将描述性字段视为可选项。
检查 `leiCount` 和 `leiRecords`。计数为 `0` 且数组为空,表示没有 GLEIF 记录与提供的 LEI 或法定名称匹配。应用程序应将其作为空搜索结果处理,而不是认为请求失败。
该端点返回结构化 JSON。客户端可以从 `vatCheck` 读取 VAT 结果,通过 `isValid` 检查有效性,通过 `viesError` 查看错误,并遍历 `leiRecords` 查找匹配实体。顶层的 `source` 标识 VAT 和 LEI 综合服务