API de Consulta de Entidades Empresariais nos EUA: Guia para Desenvolvedores

Para profissionais e desenvolvedores brasileiros que trabalham com parceiros norte-americanos, realizar uma API consulta entidades EUA confiável deixou de ser um diferencial e passou a ser uma obrigação regulatória. A Lei 9.613/98, que rege a prevenção à lavagem de dinheiro no Brasil, exige que empresas realizem diligência adequada sobre contrapartes estrangeiras — e o COAF (Conselho de Controle de Atividades Financeiras) pode responsabilizar organizações que não consigam comprovar esse processo. Se a sua aplicação processa pagamentos internacionais, onboarda parceiros americanos ou realiza operações de crédito com empresas dos EUA, integrar uma API de verificação de entidades empresariais é parte fundamental do seu stack de compliance.

Neste guia, você vai entender o contexto regulatório que justifica essa integração, conhecer a OpenSOSData — API REST especializada em registros de Secretaria de Estado dos EUA —, ver exemplos de código prontos para produção e encontrar respostas para as dúvidas mais comuns de desenvolvedores brasileiros.

Por Que Empresas Brasileiras Precisam Verificar Entidades nos EUA

Quando uma empresa brasileira firma contrato de distribuição, joint venture ou parceria de tecnologia com uma LLC ou Corporation americana, ela assume riscos que vão além do comercial. O Banco Central do Brasil (Bacen), por meio de normas como a Resolução CMN 4.753/2019, exige que instituições financeiras e empresas reguladas apliquem procedimentos de KYC (Know Your Customer/Business) também sobre contrapartes estrangeiras em operações de câmbio e remessas.

A Lei 9.613/98, atualizada pela Lei 12.683/2012, amplia o escopo das pessoas obrigadas a reportar operações suspeitas ao COAF para incluir fintechs, administradoras de cartões, empresas de factoring e diversas outras categorias. Uma verificação básica de que a empresa americana existe, está ativa e possui agente registrado válido é o primeiro passo documentável de qualquer processo de due diligence.

Do lado americano, o FinCEN (Financial Crimes Enforcement Network) publicou regras que exigem que empresas dos EUA identifiquem beneficiários finais — o que, inversamente, também pressiona os parceiros brasileiros a confirmar a legitimidade das entidades com quem operam. Para empresas brasileiras listadas na Bolsa de Nova York (NYSE/Nasdaq) ou com ADRs, a CVM igualmente pode exigir evidências de diligência sobre subsidiárias e parceiros americanos.

Em resumo: verificar se uma empresa americana está ativa no registro oficial do seu estado não é burocracia. É gestão de risco e cumprimento de lei.

O Que é a OpenSOSData API

A OpenSOSData é uma API REST que agrega dados oficiais de Secretarias de Estado (Secretary of State) de todos os 50 estados americanos, além do Distrito de Columbia (Washington D.C.), Porto Rico e Ilhas Virgens dos EUA. São mais de 34 milhões de entidades indexadas, incluindo LLCs, Corporations, LLPs, Nonprofits e outras formas jurídicas.

Para cada entidade, a API retorna:

• Nome oficial e variações registradas
• Tipo de entidade (LLC, Corporation, LP, etc.)
• ID único no registro do estado
• Status atual (Active, Dissolved, Revoked, etc.)
• Data de formação (incorporação)
• Agente registrado e endereço completo

Esses dados são exatamente os que processos de KYB (Know Your Business) demandam para documentar due diligence regulatória.

Modelo de Preços

O modelo é pay-as-you-go, sem mensalidade fixa:

Para equipes brasileiras, vale observar que mesmo o preço padrão de live lookup (aproximadamente R$ 0,55 ao câmbio atual) é muito inferior ao custo de consultas manuais ou serviços de due diligence terceirizados. Em volumes de compliance automatizado, os descontos tornam o custo unitário marginal.

Como Funciona a API: Endpoint e Parâmetros

Toda consulta é feita via POST para o endpoint:

https://api.opensosdata.com/v1/lookup

O parâmetro mais importante para controle de custo e atualidade dos dados é o cache_preference, que aceita três valores:

• live_only — sempre busca dados atualizados diretamente na fonte oficial (custo mais alto, dados mais frescos)
• cache_first — retorna cache se disponível, caso contrário faz consulta ao vivo (equilíbrio entre custo e atualidade)
• cache_only — retorna apenas dados em cache, sem consulta ao vivo (custo mínimo)

Para processos de onboarding regulatório, recomendamos live_only na primeira consulta e cache_first em verificações periódicas de monitoramento.

Consulte a documentação oficial para a lista completa de parâmetros e formatos de resposta.

Exemplo Prático: Consulta com Python

O código abaixo demonstra como integrar a OpenSOSData em um fluxo de onboarding de parceiros americanos. Ele está comentado em português para facilitar a revisão da equipe.

import requests
import json

# Configurações da API OpenSOSData
API_URL = "https://api.opensosdata.com/v1/lookup"
API_KEY = "sua_chave_aqui"  # Obtenha em https://app.opensosdata.com

def verificar_entidade_americana(nome_empresa: str, estado: str, usar_dados_ao_vivo: bool = True) -> dict:
    """
    Verifica se uma empresa americana está ativa no registro do estado.

    Parâmetros:
        nome_empresa: Nome exato ou parcial da empresa nos EUA
        estado: Sigla do estado americano (ex: 'DE', 'CA', 'NY')
        usar_dados_ao_vivo: True para compliance regulatório (COAF/KYB),
                            False para consultas de monitoramento periódico

    Retorna:
        Dicionário com dados da entidade ou mensagem de erro
    """

    # Define preferência de cache conforme necessidade regulatória
    # Para due diligence inicial: live_only (dados frescos, custo $0.10)
    # Para monitoramento periódico: cache_first (custo $0.01 se em cache)
    cache_pref = "live_only" if usar_dados_ao_vivo else "cache_first"

    headers = {
        "x-api-key": API_KEY,
        "Content-Type": "application/json"
    }

    payload = {
        "entity_name": nome_empresa,
        "state": estado,
        "cache_preference": cache_pref
    }

    try:
        response = requests.post(API_URL, headers=headers, json=payload, timeout=30)
        response.raise_for_status()
        dados = response.json()

        # Extrai informações relevantes para o dossiê de compliance
        entidade = dados.get("entity", {})
        resultado = {
            "nome_oficial": entidade.get("name"),
            "tipo": entidade.get("type"),
            "id_registro": entidade.get("entity_id"),
            "status": entidade.get("status"),
            "data_formacao": entidade.get("formation_date"),
            "agente_registrado": entidade.get("registered_agent", {}).get("name"),
            "endereco_agente": entidade.get("registered_agent", {}).get("address"),
            "estado_registro": estado,
            "fonte": "live" if cache_pref == "live_only" else "cache_first"
        }

        # Valida status ativo — crítico para processos COAF/KYB
        if resultado["status"] and resultado["status"].lower() == "active":
            resultado["aprovado_kyb"] = True
            resultado["observacao"] = "Entidade ativa — apta para onboarding regulatório"
        else:
            resultado["aprovado_kyb"] = False
            resultado["observacao"] = f"Atenção: status '{resultado['status']}' requer revisão manual"

        return resultado

    except requests.exceptions.HTTPError as e:
        return {"erro": f"Erro HTTP {response.status_code}: {str(e)}"}
    except requests.exceptions.Timeout:
        return {"erro": "Timeout na consulta. Tente novamente ou use cache_first."}
    except Exception as e:
        return {"erro": f"Erro inesperado: {str(e)}"}


# Exemplo de uso: verificando parceiro americano para due diligence
if __name__ == "__main__":
    # Consulta ao vivo para onboarding inicial (recomendado para COAF)
    resultado = verificar_entidade_americana(
        nome_empresa="Acme Technologies",
        estado="DE",
        usar_dados_ao_vivo=True
    )

    print("=== RESULTADO KYB - PARCEIRO AMERICANO ===")
    print(json.dumps(resultado, indent=2, ensure_ascii=False))

Exemplo com cURL

Para testes rápidos no terminal ou integração em scripts Shell:

# Consulta live lookup — ideal para due diligence regulatória
curl -X POST https://api.opensosdata.com/v1/lookup \
  -H "x-api-key: sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_name": "Acme Technologies",
    "state": "DE",
    "cache_preference": "live_only"
  }'

Boas Práticas de Integração para Compliance Brasileiro

Ao construir um fluxo de KYB com a API, considere as seguintes práticas alinhadas ao contexto regulatório brasileiro:

• Registre cada consulta: Armazene o payload de resposta completo, incluindo timestamp. O COAF pode solicitar evidências do processo de due diligence com data e hora da verificação.
• Use live_only no onboarding: Para o primeiro cadastro de um parceiro americano, dados ao vivo são necessários para comprovar que a verificação foi feita na fonte oficial.
• Automatize monitoramento periódico: Com cache_first, você pode verificar mensalmente se o status de parceiros recorrentes permanece ativo, com custo mínimo.
• Trate status não-ativos como alerta vermelho: Entidades com status "Dissolved", "Revoked" ou "Suspended" devem acionar revisão manual antes de qualquer remessa ou pagamento.
• Combine com dados de beneficiário final: A consulta de entidade não substitui a identificação de UBO (Ultimate Beneficial Owner), mas é o primeiro passo documentável.

Para começar, crie sua conta em app.opensosdata.com e explore os planos disponíveis.

Perguntas Frequentes

Conclusão

Integrar uma API consulta entidades EUA ao seu stack de compliance não é apenas uma decisão técnica — é uma resposta direta às exigências da Lei 9.613/98, às normas do COAF e às expectativas do Bacen para operações com contrapartes americanas. A OpenSOSData oferece cobertura nacional completa nos EUA, dados diretos de fontes oficiais e um modelo de preço acessível que viabiliza tanto o onboarding regulatório quanto o monitoramento contínuo de parceiros.

Com o exemplo de código Python fornecido neste guia, você pode ter uma integração funcional em poucas horas. O próximo passo é simples: crie sua conta em app.opensosdata.com, gere sua chave de API e comece a verificar suas contrapartes americanas com dados oficiais e rastreáveis.