POST AI agent ready /v1/validate/vat

VAT 番号検証 API - 無料の EU VAT チェック

VAT 番号を送信すると、それがその国の予期される形式と一致するかどうかを確認する返信が届きます。すべての EU 加盟国をサポートします。 B2B の請求書発行、免税チェックアウトフロー、コンプライアンスチェックに役立ちます。 VAT 番号はサーバー側で処理され、保存されることはありません。

Endpoint

curl -X POST https://api.botoi.com/v1/validate/vat \
  -H "Content-Type: application/json" \
  -d '{"vat_number":"DE123456789"}'

When to use this API

チェックアウト時にゼロレート VAT 免除を適用する前に、購入者の VAT ID を検証してください。これにより、間違った請求書の発行や税務調査時の潜在的な罰則から保護されます。

VAT ID から国コードを抽出して、各 EU 加盟国に正しい VAT 税率、請求書の言語、レポート要件を自動的に適用します。

顧客データベースをエンドポイント経由で定期的に実行します。無効または期限切れの VAT ID を持つアカウントにフラグを立てて、財務チームが次の請求サイクルの前に更新された書類をリクエストできるようにします。

どの国がサポートされていますか?

EU 加盟 27 か国すべて。各国には独自の VAT 番号形式があります (例: ドイツの場合は DE + 9 桁、フランスの場合は FR + 11 文字)。 API は、検出された国の正しいパターンに対して検証します。

この API は VIES データベースと照合して VAT 番号をチェックしますか?

このエンドポイントは、VAT 番号の形式と構造を検証します。登録ステータスを確認するためのリアルタイム VIES (EU 委員会) ルックアップについては、公式 VIES SOAP サービスと組み合わせてください。

VAT 番号は検証後に保存されますか?

いいえ。番号はメモリ内で処理され、応答後に破棄されます。データはディスクや外部システムに書き込まれません。

英国の VAT 番号を検証できますか?

英国の VAT 番号 (GB プレフィックス) は既知の形式に従っており、構造的に検証できます。英国が EU を離脱したため、VIES の一部ではなくなりましたが、フォーマットチェックは引き続き機能します。

国の接頭辞を付けずに番号を送信するとどうなりますか?

API には 2 文字の国接頭語 (例: 「DE」、「FR」、「NL」) が必要です。これがないと、応答は、国コードが欠落していることを説明する理由とともに valid: false を返します。

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.