Cómo verificar una entidad comercial estadounidense mediante API en Python

Publicado 2026-04-11 por OpenSOSData

La verificación de la entidad comercial es un paso fundamental en el cumplimiento del KYB, la incorporación de proveedores y la diligencia debida. En lugar de buscar manualmente en el sitio web de la Secretaría de Estado de cada estado, puede verificar cualquier entidad empresarial estadounidense mediante programación utilizando la API OpenSOSData.

Requisitos previos

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

Búsqueda básica

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')}")

Tratamiento de errores

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.

Búsqueda multiestatal

Haz un bucle a través de los códigos de estado para buscar en varios estados. Cada llamada cuesta 0,0314 $ (las búsquedas en caché son gratuitas).

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.