PythonでAPI経由で米国事業体を検証する方法

OpenSOSDataによる2026-04-11発行

事業体の検証は、KYBのコンプライアンス、ベンダーのオンボーディング、およびデューデリジェンスにおいて重要なステップです。各州の州務長官ウェブサイトを手作業で検索する代わりに、OpenSOSData APIを使用して、プログラム上であらゆる米国の事業体を検証することができます。

前提条件

• Python 3.7+
• An OpenSOSData API key (sign up here)
• The requests library: pip install requests

基本的な検索

import requests

API_KEY = "osd_your_api_key_here"
BASE_URL = "https://api.opensosdata.com/v1/lookup"

def lookup_entity(name, state):
    response = requests.post(
        BASE_URL,
        headers={
            "x-api-key": API_KEY,
            "Content-Type": "application/json"
        },
        json={
            "entity_name": name,
            "state": state
        }
    )
    return response.json()

result = lookup_entity("Apple Inc", "DE")

if result.get("success"):
    data = result["data"]
    print(f"Entity: {data['entityName']}")
    print(f"Status: {data['status']}")
    print(f"Type: {data['entityType']}")
    print(f"Agent: {data.get('registeredAgentName', 'N/A')}")
else:
    print(f"Failed: {result.get('error')}")

エラー処理

A 200 with "success": true means a match was found. A 200 with "success": false means no match. A 402 means your wallet is empty.

複数州検索

複数の州を検索するには、州コードをループします。各コールの料金は$0.0314（キャッシュヒットは無料）。

states = ["DE", "NV", "FL", "TX", "CA"]
for state in states:
    result = lookup_entity("Global Financial Impact LLC", state)
    if result.get("success") and result.get("data"):
        print(f"Found in {state}: {result['data']['entityName']}")
        break

For more details, see the full API documentation. For state coverage, visit the state coverage page.