EU VAT 番号検証 API
欧州委員会の公式レジストリ VIES に照会して EU の付加価値税番号を検証します。リアルタイムでの確認に加え、加盟国が開示している場合は登録上の名称と所在地も返します。
統合ガイド
スニペットをコピーし、APIキーを差し替えて実行するだけ。任意のHTTPクライアントで動作します — 以下にcURL、JavaScript、Pythonの例を掲載。
/api/validate-vathttps://www.apipick.comValidate 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"{
"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 番号を、請求システムや税務申告に届く前に捕捉します。
エージェントのワークフロー
請求書処理中に呼び出せる単一パラメータのツールを財務エージェントに与え、曖昧さのない真偽値の答えを返します。
レスポンスのフィールド
| フィールド | 型 | 説明 |
|---|---|---|
| valid | boolean | その番号が現在、国境を越える取引向けに登録されているかどうか |
| country_code | string | 申告上の加盟国コード（ギリシャは EL、北アイルランドは XI） |
| number | string | 国コードの接頭辞を除いた VAT 番号本体 |
| name | string | null | 登録上の事業者名（加盟国が開示している場合） |
| address | string | null | 登録上の所在地（加盟国が開示している場合） |
| name_disclosed | boolean | 加盟国が方針として身元項目を非開示にしている場合は false（ドイツ、スペイン） |
| request_date | string | null | VIES がこの照会に記録したタイムスタンプ |
| consultation_number | string | null | VIES の照会識別子。確認済みであることの証跡として使えます |
| credits_used | integer | このリクエストで差し引かれたクレジット |
| remaining_credits | integer | アカウントに残っているクレジット |
レート制限
スロットリングはAPIキー単位、60秒のスライディングウィンドウです。上限に達すると、Retry-Afterヘッダー付きのクリーンな429が返されます。
20req/min
APIキー単位・エンドポイント単位。60秒のスライディングウィンドウ。
3concurrent
APIキーごとの同時進行リクエストの最大数。
X-RateLimit-Limit1分あたりに許可される最大リクエスト数X-RateLimit-Remaining現在のウィンドウで残っているリクエスト数X-RateLimit-Reset現在のウィンドウがリセットされるまでの秒数Retry-After再試行までの待機秒数（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 に対して行われ、VIES は各リクエストをリアルタイムで当該加盟国自身の税務データベースへ転送します。当社はレジストリの複製を一切保持しません。答えは税務当局のものであり、当社は障害時と非開示のケースを明示したうえで、整った JSON としてお届けするだけです。
よくある質問
Q: これは EU 公式の照会ですか？
A: はい。リクエストは欧州委員会の付加価値税情報交換システム VIES に送られ、VIES が当該加盟国自身の税務データベースをリアルタイムで照会します。中間のデータベースは介在しないため、ここでの結果は欧州委員会の Web フォームで得られるものと一致します。
Q: ドイツの番号で事業者名が空なのはなぜですか？
A: ドイツとスペインは方針として、VIES を通じて事業者名と所在地を開示していません。番号が登録済みかどうかは変わらず明確に返りますが、身元に関する項目だけが非開示になります。レスポンスでは name_disclosed: false が設定されるため、方針による非開示と、本当に値がない場合とを区別できます。
Q: 加盟国のシステムが停止しているときはどうなりますか？
A: VIES は各加盟国自身のデータベースに振り分けており、それらは保守のため停止することがあります。その場合は明確なメッセージとともに HTTP 503 が返り、クレジットは消費されません。数分後に再試行してください。障害は税務当局側にあり、当社側ではありません。
Q: どの国コードに対応していますか？
A: 全 27 加盟国に加え、ウィンザー枠組みに基づく北アイルランドの XI に対応しています。ギリシャは ISO コードの GR ではなく EL で VAT を申告する点にご注意ください。英国本土（GB）は Brexit 後に VIES から離脱しており、対象外です。
Q: 監査証跡用の照会番号は取得できますか？
A: VIES が照会識別子を発行した場合、consultation_number フィールドに含まれます。この識別子は、特定の日付に取引相手の VAT 状況を確認したことの証拠として税務当局に認められるものであり、リバースチャージ請求で重要になります。