apipick
[ 驗證 · 稅務 ]● 3 點數 · 20 次/分鐘

歐盟 VAT 稅號驗證 API

對接歐盟執委會官方 VIES 系統驗證任一歐盟加值稅號。即時確認註冊狀態，並在會員國願意揭露時回傳納稅主體的法定名稱與地址。

官方 VIES 資料源27 國 + XI即時查核
auth · x-api-key

還沒有 API 金鑰?

登入帳戶以建立並管理您的 API 金鑰。

登入管理 API 金鑰
[ 02 · integrate ]

整合指南

複製程式碼片段，替換你的 API 金鑰，執行即可。適用於任何 HTTP 用戶端——下方提供 cURL、JavaScript 與 Python 範例。

spec
GET/api/validate-vat
base
https://www.apipick.com

Validate an EU VAT number against the official VIES registry

參數
vat_numberstring必填

Full VAT number with its two-letter member-state prefix. Spaces, dots, and hyphens are stripped. IE6388047V

countrystring選填

Member-state code, if the number is supplied without its prefix. Greece is EL, not GR. IE

curl -X GET "https://www.apipick.com/api/validate-vat" \
  -H "x-api-key: YOUR_API_KEY"
● 200 · 回應
{
  "vat_number": "IE6388047V",
  "country_code": "IE",
  "number": "6388047V",
  "valid": true,
  "name": "GOOGLE IRELAND LIMITED",
  "address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
  "name_disclosed": true,
  "request_date": "2026-09-01T11:52:22.440Z",
  "consultation_number": null,
  "source": "European Commission VIES",
  "credits_used": 3,
  "remaining_credits": 97
}

為實際使用情境打造

🧾

逆向課稅開立發票

在對跨境 B2B 發票適用零稅率前，先確認買方的 VAT 註冊狀態，並將此次查核留存備查。

🚪

B2B 開戶

在註冊環節即時驗證，並以註冊庫中的法定名稱與地址自動預先填入，不必再讓客戶手動輸入。

🛡️

詐欺防範

在虛構或已失效的 VAT 稅號進入你的計費系統或稅務申報前就先攔下。

🤖

代理工作流程

為財務代理提供一個單參數工具，可在處理發票時隨手呼叫，並取得毫不含糊的布林結果。

回應欄位

欄位類型說明
validboolean此稅號目前是否已註冊可用於跨境貿易
country_codestring申報所用的會員國代碼（希臘為 EL，北愛爾蘭為 XI）
numberstring去除國別前綴後的稅號本體
namestring | null登記的納稅主體名稱（以會員國是否揭露為準）
addressstring | null登記地址（以會員國是否揭露為準）
name_disclosedboolean當會員國依政策不揭露身分欄位時為 false（德國、西班牙）
request_datestring | nullVIES 為本次查核所記錄的時間戳記
consultation_numberstring | nullVIES 核發的查詢編號，可作為已查核的憑證
credits_usedinteger本次請求扣除的點數
remaining_creditsinteger您帳戶中剩餘的點數
[ 03 · limits ]

速率限制

限流以 API 金鑰計，採用 60 秒滑動視窗。觸發限制時會回傳乾淨的 429，並帶 Retry-After 回應標頭。

請求速率

20req/min

以 API 金鑰、以端點計。60 秒滑動視窗。

並行

3concurrent

每個 API 金鑰同時進行中的最大請求數。

回應標頭
X-RateLimit-Limit每分鐘允許的最大請求數
X-RateLimit-Remaining目前視窗內剩餘的請求數
X-RateLimit-Reset目前視窗重設前的秒數
Retry-After重試前需等待的秒數（僅在 429 時）
● 429 · 請求過多
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 20 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}

資料來源與授權

查核透過歐盟執委會的加值稅資訊交換系統 VIES 完成，該系統會把每次查詢即時轉送至對應會員國自己的稅務資料庫。我們不保有任何註冊庫副本 —— 結論來自稅務機關本身，我們只是以乾淨的 JSON 回傳，並把服務中斷與揭露政策兩類情況明確標示出來。

常見問題

問: 這是歐盟官方的查核嗎？

答: 是的。請求送往歐盟執委會的加值稅資訊交換系統 VIES，由它即時查詢對應會員國自己的稅務資料庫。中間沒有任何快取資料庫，因此這裡的結論與你在執委會官網表單上查到的一致。

問: 為什麼德國稅號查不到納稅主體名稱？

答: 德國與西班牙基於政策不透過 VIES 揭露納稅主體的名稱與地址。稅號是否有效註冊仍會明確給出，只是身分欄位不予公開。回應中會設定 name_disclosed: false，讓你能區分「政策性遮蔽」與「欄位確實為空」。

問: 會員國系統故障時會怎樣？

答: VIES 會把請求導向各會員國自己的資料庫，而這些系統會因維護而離線。發生此情況時，介面回傳 HTTP 503 並附上清楚說明，且不扣除點數。請過幾分鐘重試 —— 故障在稅務機關那一側，不在我們這裡。

問: 支援哪些國別代碼？

答: 支援全部 27 個會員國，外加《溫莎架構》下代表北愛爾蘭的 XI。請注意希臘的加值稅國別代碼是 EL，而非其 ISO 代碼 GR。英國本島（GB）在脫歐後已退出 VIES，不在涵蓋範圍內。

問: 能取得供留存軌跡的查詢編號嗎？

答: 當 VIES 核發查詢編號時，會透過 consultation_number 欄位回傳。該編號正是稅務機關認可的憑證，用以證明你曾在某一日期查核過交易對象的 VAT 狀態 —— 這對逆向課稅開立發票尤其重要。