Venue Authority

Venue Authority API

Venue Authority は、飲食サービス事業者の名称と住所を、対応する米国の規制当局の記録と照合します。各判定には照合元と証拠の範囲が含まれるため、事業者のオンボーディングチームは、不透明な「はい」か「いいえ」に頼らず、監査用の記録を保持できます。

決済ファシリテーター、マーケットプレイス、KYB プロバイダー、レストランプラットフォームなど、オンボーディング中に所在地を確認する必要がある組織向けに構築されています。対応ワークスペースで利用できるウォッチリストと Webhook の操作については、ドキュメントをご覧ください。有料のモニタリング拡張はまだ利用できません。現在の提供状況は、ステータスページと料金ページでご確認ください。

まず対応状況を確認する

カバレッジエンドポイントに API キーは必要ありません。

curl https://venueauthority.com/api/v1/coverage

レスポンスには、現在 API で利用できる管轄区域、規制当局の情報源、情報源クラス、鮮度の状態が表示されます。事業者の記録を送信する前に確認してください。

登録前に判定を確認する

公開されている Portfolio Proof の例を開くと、情報源に紐づいた承認判定、却下判定、証拠の範囲を確認できます。この固定例の確認に、アカウントの作成やファイルのアップロードは必要ありません。

判定をテストする

1. 検証済みワークスペースを作成します。
2. ダッシュボードでテストキーを作成します。利用資格のある検証済みワークスペースには、25 テストユニットが一度だけ付与されます。
3. 安定したリクエスト ID とともに、事業者の名称と住所を送信します。

curl -X POST https://venueauthority.com/api/v1/resolve \
  -H 'Authorization: Bearer YOUR_ONE_TIME_KEY' \
  -H 'X-Request-Id: quickstart-000001' \
  -H 'Content-Type: application/json' \
  --data '{"name":"MERCHANT NAME","address":"STREET ADDRESS"}'

有効な判定では、判定結果、ポリシー上の理由、情報源の識別情報、情報源クラス、情報源の帰属情報、スナップショット、証拠の範囲が返されます。同じペイロードで同じリクエスト ID を再送すると、追加の引き落としなしで保存済みの結果が返されます。

インテグレーション用ファイル

• OpenAPI 3.1 コントラクト
• Postman コレクション
• 10 分でできるクイックスタート

このコントラクトでは、正規の施設レコード、ポートフォリオ、監査エクスポート、Webhook、Webhook 配信履歴も扱います。

クライアントパッケージ

このリポジトリには、レビュー済みのバージョン管理されたインテグレーションが 3 つ含まれています。

• Node.js SDK：Node 18 以降に対応しています。実行時の依存関係はありません。
• Python SDK：Python 3.9 以降に対応しています。実行時には標準ライブラリのみを使用します。
• MCP サーバー：公開カバレッジ、施設の解決、または正規の施設証拠を必要とする MCP ホスト向けです。

v0.1.0 リリースには、ワンクリックで導入できる MCP バンドルと、3 つすべてのクライアントのダウンロード可能なアーカイブが含まれています。npm と PyPI のリリースについては、対応するレジストリへの公開が成功した後にのみ、ここで案内します。

製品の対象範囲

Venue Authority は、送信された施設を対応する規制当局の記録に照合します。法的な運営者を推測したり、事業者が実際に営業中であることを証明したり、API が返すカバレッジの範囲外を検索したりするものではありません。一致が不確かな場合は却下されます。

リンク

• 開発者向けドキュメント
• カバレッジ
• 料金
• サービスのステータス
• サポート
• 利用規約

このリポジトリには、公開されているインテグレーション用成果物が含まれています。ホスト型 API の利用には、Venue Authority の利用規約が適用されます。