EU VAT Validation API

Validate any European VAT number in real-time using the official EU VIES service. Returns validity, registered company name, and address as clean JSON. Covers all 27 EU member states plus Northern Ireland (XI).

原始信息汇总

EU VAT Validation API 数据集概述

基本信息

• API名称: EU VAT Validation API
• 提供商: JoCoder77
• 类别: Business Software
• 基础URL: https://euvat-api.vercel.app
• 主要功能: 实时验证任何欧洲增值税号，使用官方的欧盟VIES服务。返回有效性、注册公司名称和地址，格式为干净的JSON。覆盖所有27个欧盟成员国以及北爱尔兰（XI）。

定价计划

• BASIC: $0.00 / 月
• PRO: $1.99 / 月
• ULTRA: $5.99 / 月
• MEGA: $14.99 / 月

性能指标

• 流行度: 1.9
• 服务等级: 100%
• 延迟: 698ms

端点详情

1. POST /api/validate-vat

验证欧洲增值税号。

请求

• Headers: Content-Type: application/json
• Body参数:
  • countryCode: 字符串，必需，2字母欧盟国家代码（例如 DE, FR）。希腊使用 EL，北爱尔兰使用 XI。
  • vatNumber: 字符串，必需，不带国家前缀的增值税号。空格会自动去除。

响应 (200 — 成功)

• valid: 布尔值，增值税号是否已注册且有效。
• companyName: 字符串 | null，注册公司名称，如果国家不提供则为 null。
• address: 字符串 | null，注册地址，如果国家不提供则为 null。
• note: 字符串 | null，如果国家不共享公司/地址数据的解释说明。
• countryCode: 字符串，来自请求的规范化国家代码。
• vatNumber: 字符串，来自请求的规范化增值税号。
• cached: 布尔值，如果结果来自缓存则为 true。
• stale: 布尔值，如果缓存结果超过24小时则为 true（当VIES服务不可用时作为备用返回）。
• response_time_ms: 数字，总请求持续时间（毫秒）。

速率限制

• 每个IP每60秒10个请求。
• 响应头包含:
  • X-RateLimit-Limit: 每个窗口的最大请求数（始终为 10）。
  • X-RateLimit-Remaining: 当前窗口中剩余的请求数。
  • X-RateLimit-Reset: 窗口重置的Unix时间戳。

错误响应

所有错误均返回包含 error 字段和 response_time_ms 的JSON。

• 400: 请求体中缺少字段或字段类型错误。
• 405: HTTP方法错误。
• 422: 未知国家代码，或VIES拒绝的增值税号格式。
• 429: 超出速率限制。同时返回 retryAfter（秒）。
• 503: VIES服务或特定国家机构不可用。
• 504: VIES请求超时（10秒限制）。

支持的国家

代码	国家	返回公司/地址
AT	奥地利	是
BE	比利时	是
BG	保加利亚	是
CY	塞浦路斯	是
CZ	捷克共和国	否
DE	德国	否
DK	丹麦	是
EE	爱沙尼亚	是
EL	希腊	是
ES	西班牙	否
FI	芬兰	是
FR	法国	是
HR	克罗地亚	是
HU	匈牙利	是
IE	爱尔兰	是
IT	意大利	否
LT	立陶宛	是
LU	卢森堡	是
LV	拉脱维亚	是
MT	马耳他	是
NL	荷兰	是
PL	波兰	是
PT	葡萄牙	是
RO	罗马尼亚	是
SE	瑞典	是
SI	斯洛文尼亚	是
SK	斯洛伐克	否
XI	北爱尔兰	是

缓存行为

• 结果缓存 24小时。
• 缓存命中返回时间 低于100ms，而实时VIES调用约为500–2000ms。
• 如果VIES服务不可用且存在缓存结果（即使超过24小时），则返回该结果并标记 "stale": true，而不是使请求失败。
• 如果VIES服务不可用且完全没有缓存，则返回 503 错误。

代码示例

• JavaScript: 使用 fetch 发送POST请求。
• Python: 使用 requests 库发送POST请求。
• PHP: 使用 file_get_contents 和 stream_context_create 发送POST请求。

搜集汇总

背景与挑战

背景概述

该数据集提供欧盟增值税号的实时验证服务，通过官方VIES接口返回有效性、公司名称和地址的标准化JSON信息，覆盖所有27个欧盟成员国及北爱尔兰地区。