ScreenVeritAI · API Specv1 · GA · reference
    開発者向けAPI

    システム間で名前をコピー&ペーストする必要はありません。1回のAPI呼び出しですべて完結します。

    法人確認、出資構造マッピング、PEPチェック、アドバースメディア、制裁リスト照合を、既存のワークフローに直接組み込めます。

    The request

    p. 01 / 09

    One POST call, then your poll loop.

    Entity name, type, country, screening type. The call returns 202 with a search_id and an ETA, and the agent works in the background — you poll for the result rather than hold the connection open.

    entity_nameRequired, 1-500 characters. Alias-aware matching
    entity_type"person", "company" or "any" (default "any")
    countryOptional jurisdiction hint that sharpens identity resolution
    search_type"sanctions_check", "adverse_media" or "full_search"
    POST /api/v1/search
    bash
    1curl -X POST https://screenveritai.com/api/v1/search \
    2 -H 'X-API-Key: YOUR_API_KEY' \
    3 -H 'Content-Type: application/json' \
    4 -d '{
    5 "entity_name": "Acme Trading LLC",
    6 "entity_type": "company",
    7 "country": "AE",
    8 "search_type": "sanctions_check"
    9 }'
    10# 202 Accepted
    11# { "search_id": "SEARCH_ID", "status": "processing",
    12# "estimated_time_seconds": 15 }

    The response

    p. 02 / 09
    GET /api/v1/search/{search_id} — response
    200 OK
    1{
    2"id": "SEARCH_ID",
    3"entity_name": "Acme Trading LLC",
    4"entity_type": "company",
    5"status": "completed",
    6"search_type": "sanctions_check",
    7"ofac_sanctions": "## OFAC Sanctions Findings\n\n
    8**Status:** *Sanctioned*\n\n**Details:**\n
    9- **Matched entity:** ACME TRADING LLC\n
    10- **Authority:** US Treasury OFAC\n...",
    11"eu_sanctions": "## EU Sanctions Findings\n\n
    12**Status:** *No relevant listing found*\n...",
    13"sanctions_sources": [
    14{ "source_id": "ofac_sanctions", "title": "OFAC Sanctions",
    15"authority": "US Treasury OFAC", "hit_count": 1 },
    16{ "source_id": "eu_sanctions", "title": "EU Sanctions",
    17"authority": "", "hit_count": 0 }
    18],
    19"criminal_watchlists": null,
    20"pep": null,
    21"news_summary": null,
    22"final_report": null,
    23"created_at": "2026-09-04T09:20:03.771000+00:00",
    24"completed_at": "2026-09-04T09:20:19.088000+00:00"
    25}
    No relevant listing found / null
    Sanctioned / potential match
    Per-source hit_count
    Status and search_type

    Structured JSON. Findings, not a score.

    One field per sanctions source, plus criminal watchlists and PEP. Each finding is markdown carrying the status line, the matched entity, the authority and an evidence URL — there is no numeric score and no risk tier, because a number hides the line an auditor asks to see.

    "ofac_sanctions"One markdown field per jurisdiction; read the *Status:* line
    "sanctions_sources"source_id, title, authority, details, hit_count per source
    "criminal_watchlists"Markdown when matched, null when nothing matched
    "pep"Markdown when matched, null when nothing matched
    "news_summary"Adverse-media report on adverse_media and full_search
    "status"completed when done; error_* on failure

    API reference

    p. 03 / 09

    Three calls cover a screening integration: queue it, poll it, or hand over a file.

    API reference — endpoints
    v1 · rest
    POST
    /api/v1/search

    Queue a screening run. Returns immediately with a search_id; the work happens in the background.

    Request

    curl -X POST https://screenveritai.com/api/v1/search \
    -H 'X-API-Key: YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d '{"entity_name": "Acme Trading LLC", "entity_type": "company",
    "country": "AE", "search_type": "sanctions_check"}'

    Response

    202 Accepted
    { "search_id": "SEARCH_ID", "status": "processing",
    "message": "Search queued successfully. Poll the GET endpoint for results.",
    "estimated_time_seconds": 15 }

    Integration patterns

    p. 04 / 09

    The API sits between data entry and decision — wherever you need a risk signal.

    Customer onboarding
    Customer signupPOST /api/v1/searchPoll until completedApprove / hold
    Payment processing
    Transaction initPOST /api/v1/searchPoll until completedRelease / hold
    CRM re-screen
    Record updatedYour scheduler firesPOST /api/v1/searchWrite result back

    自社開発 対 ScreenVeritAI連携

    p. 05 / 09
    本番稼働までの期間
    自社開発
    リストの調達、照合ロジックの構築、例外処理の実装に6~12か月
    ScreenVeritAI API
    数日で連携完了 — 最初のAPI呼び出しから本番運用可能
    制裁リストの収録範囲
    自社開発
    各リスト形式を手作業で取り込み、スキーマを継続的に保守
    ScreenVeritAI API
    すべての主要ソースを継続的に維持・更新
    照合精度
    自社開発
    独自のあいまい照合にはNLPの専門知識と絶え間ない調整が必要
    ScreenVeritAI API
    あいまい照合、音訳、別名解決、音声アルゴリズムを備えたAI
    PEP・アドバースメディア
    自社開発
    別々のベンダー、別々の連携、別々の予算が必要
    ScreenVeritAI API
    PEP、アドバースメディア、UBOデータを同じAPIレスポンスで取得
    継続的な保守
    自社開発
    リスト更新、スキーマ変更、誤検知の調整に専任チームが必要
    ScreenVeritAI API
    フルマネージド — 更新・改善・インフラをすべて代行
    監査証跡
    自社開発
    ログ・エビデンス・保存のための独自基盤を構築する必要あり
    ScreenVeritAI API
    出典付きのタイムスタンプ入りエビデンスバンドルが標準搭載

    コンプライアンス組み込みまでの4ステップ

    p. 06 / 09
    1

    APIキーを取得する

    ダッシュボードから、search:read、search:write、batch:read、batch:writeといった最小権限のスコープ付きキーを作成します。

    2

    エンドポインを組み込む

    オンボーディング、決済、CRMのワークフローにPOST呼び出しを1回追加するだけです。エンティティ名、種別、国を送信すると、ジョブIDが返されます。

    3

    結果を処理する

    結果取得エンドポイントをポーリングして、構造化されたJSONを取得します — 法人情報、出資構造、PEP、アドバースメディア、制裁リストの情報、リスクスコアが含まれます。

    4

    モニタリングとアラートを設定する

    継続的モニタリングを設定すれば、制裁リストが更新されたり新たなアドバースメディアが見つかったりした際に、APIがアラートを送信します。

    数分で始められます

    p. 07 / 09

    1回のAPI呼び出しで、完全なスクリーニング結果が返されます。

    エンティティをスクリーニング
    bash
    curl -X POST https://screenveritai.com/api/v1/search \
      -H 'X-API-Key: YOUR_API_KEY' \
      -H 'Content-Type: application/json' \
      -d '{"entity_name": "Acme Trading LLC", "country": "AE", "search_type": "sanctions_check"}'
    
    # 202 Accepted
    # { "search_id": "SEARCH_ID", "status": "processing", "estimated_time_seconds": 15 }
    結果を確認
    bash
    curl https://screenveritai.com/api/v1/search/SEARCH_ID \
      -H 'X-API-Key: YOUR_API_KEY'
    
    # 200 OK
    # { "id": "SEARCH_ID", "status": "completed",
    #   "ofac_sanctions": "## OFAC Sanctions Findings ... *No relevant listing found* ...",
    #   "criminal_watchlists": null, "pep": null }

    APIのパフォーマンス

    p. 08 / 09

    €0.39

    Quick Check 1回あたり、プラットフォーム料金なし

    202

    検索が受理されたときのHTTPステータス。その後、結果をポーリングで取得

    EU

    フィンランドでホスティング。保存データはEU域内に留まります

    API連携FAQ

    p. 09 / 09
    01APIリクエストはどのように認証しますか?
    APIリクエストは、X-API-Keyヘッダーで渡すシークレットキーを使って認証します。キーはダッシュボードから、必要最小限のスコープ付き権限で作成できます。
    02APIは同期型ですか、非同期型ですか?
    非同期型です。リクエストを送信するとジョブIDが返され、結果はポーリングで取得します。パイプラインがブロックされることはありません。
    03APIはどのようなレスポンス形式を返しますか?
    制裁該当、PEPフラグ、アドバースメディア、信頼度スコア、出典情報、リスクレベル分類を含む構造化されたJSONです。
    04どのようなレート制限が適用されますか?
    サブスクリプションのプランごとに、APIキー単位で割り当てられます。レスポンスヘッダーには残りクォータとリセット時刻が含まれます。
    05APIでエンティティを一括スクリーニングできますか?
    できます。一括処理用のエンドポイントは、1リクエストあたり最大100行のCSVまたはXLSXを受け付け、結果は行単位、または完全なエクスポートとして取得できます。
    06APIで継続的モニタリングを設定するにはどうすればよいですか?
    初回スクリーニングの後にモニタリングを設定します。リストが更新されたり新たなアドバースメディアが見つかったりすると、モニタリングがその変化を検出し、アプリ内で通知します。
    07各スクリーニング結果にはどのようなコンプライアンスデータが含まれますか?
    あらゆる主要ソースにわたる制裁該当情報、家族関係を含むPEPステータス、多言語の出典付きアドバースメディア、UBOデータ、リスクレベル、タイムスタンプ付きエビデンスバンドルが含まれます。
    08スクリーニングにはどれくらい時間がかかりますか?
    標準の制裁チェックは数秒で完了します。アドバースメディアや出資構造マッピングを含む詳細調査は2分未満です。
    API用語集
    REST API
    標準的なHTTPメソッドを使用するWeb API。HTTPリクエストを送信できる、あらゆる言語やフレームワークと互換性があります。
    非同期処理
    APIはジョブを即座に受け付け、バックグラウンドで処理します — 結果はポーリングで取得します。
    APIキー
    APIリクエストを認証するための秘密トークンで、最小権限アクセスのために特定の権限がスコープされています。
    レート制限
    サブスクリプションのプランごとに、一定時間内のAPIリクエスト数を制限します — 残りクォータとリセット時刻はレスポンスヘッダーに含まれます。
    構造化レスポンス
    一貫したフィールド名と型を持つ機械可読なJSONで、自動的な解析と判断ロジックの実装を可能にします。
    chk api-v1svai-api-specv1 · ga2 samples · reference

    End of API specification.

    スクリーニングは数分で始められます。

    プランをお選びいただき、今すぐスクリーニングを開始しましょう。