💡A API OFAC - Sanções permite verificar listas de sanções como a SDN List e outras administradas pelo Office of Foreign Assets Control (OFAC), garantindo conformidade com regulamentos e prevenindo transações com entidades sancionadas.


Introdução

A API OFAC - Sanções é utilizada para verificar sanções aplicadas a indivíduos ou entidades com base em nomes fornecidos. É uma ferramenta crítica para compliance, due diligence e prevenção de lavagem de dinheiro.


URL Base

A API está hospedada no seguinte endereço:

https://api.directd.com.br

Endpoint

Consulta OFAC - Sanções

GET /api/OFAC

Descrição: Endpoint para consultar sanções do OFAC.

Nota: Esta consulta não gera comprovantes.


Autenticação

Para acessar esta API, é necessário fornecer um token de autenticação.

Regras de Autenticação:

  1. O token deve ser enviado como parâmetro na URL da requisição.
  2. O token é obrigatório para realizar consultas.

Campos da API

Dados Gerais

  • Nome Consultado: Nome da entidade ou pessoa pesquisada.
  • Resultados Encontrados: Número de ocorrências localizadas.
  • Data da Lista SDN: Data da última atualização da lista SDN.
  • Data da Lista NONSDN: Data da última atualização da lista NONSDN.

Detalhes das Sanções

  • Nome: Nome do indivíduo ou entidade sancionada.
  • Sobrenome: Sobrenome (se aplicável).
  • Data de Nascimento: Data de nascimento.
  • Local de Nascimento: Local de nascimento.
  • Nacionalidade: Nacionalidade do sancionado.
  • Cidadania: Cidadania do sancionado.
  • Lista: Nome da lista em que consta a sanção.
  • Programa: Programa de sanções associado.

Identificações

  • Tipo: Tipo de identificação (ex.: passaporte, ID).
  • Descrição: Detalhes sobre a identificação.
  • País: País emissor.
  • Data de Emissão: Data de emissão do documento.
  • Data de Expiração: Data de validade do documento.

Apelidos

  • Tipo: Tipo de apelido (ex.: nome alternativo).
  • Categoria: Categoria do apelido.
  • Nome: Nome alternativo listado.

Endereços

  • Endereço: Detalhes do endereço.
  • Cidade: Cidade.
  • Estado: Estado.
  • Código Postal: Código postal.
  • País: País.

Parâmetros

NomeTipoObrigatórioDescrição
NOMEstringSimNome da pessoa ou entidade a ser consultada.
SOBRENOMEstringNãoSobrenome da pessoa a ser consultada.
TOKENstringSimToken de autenticação necessário para a consulta.

Exemplos de Requisição

Usando cURL

curl 'https://api.directd.com.br/api/OFAC?NOME=John&SOBRENOME=Doe&TOKEN=seu_token_aqui'

Respostas

Sucesso (200)

Exemplo de Resposta

{
  "metaDados": {
    "consultaNome": "OFAC - Sanções",
    "consultaUid": "ofac-123456",
    "usuario": "Maria Silva",
    "mensagem": "Sucesso",
    "apiVersao": "v3",
    "tempoExecucaoMs": 260
  },
  "retorno": {
    "nomeConsultado": "JOHN DOE",
    "resultadosEncontrados": 1,
    "dataListaSDN": "2024-12-01",
    "dataListaNONSDN": "2024-12-01",
    "sancoes": [
      {
        "nome": "JOHN",
        "sobrenome": "DOE",
        "dataNascimento": "1980-01-15",
        "localNascimento": "New York, USA",
        "nacionalidade": "American",
        "cidadania": "USA",
        "lista": "SDN List",
        "programa": "OFAC Sanctions Program",
        "identificacoes": [
          {
            "tipo": "Passaporte",
            "descricao": "Passaporte emitido pelo governo dos EUA",
            "pais": "USA",
            "dataEmissao": "2015-01-01",
            "dataExpiracao": "2025-01-01"
          }
        ],
        "apelidos": [
          {
            "tipo": "Nome Alternativo",
            "categoria": "Pseudônimo",
            "nome": "Johnny D."
          }
        ],
        "enderecos": [
          {
            "endereco": "123 Main St",
            "cidade": "New York",
            "estado": "NY",
            "codigoPostal": "10001",
            "pais": "USA"
          }
        ]
      }
    ]
  }
}

9. Erros Comuns

CódigoDescrição
400Requisição inválida: parâmetros incorretos.
401Não autenticado: token inválido ou ausente.
403Não autorizado: saldo insuficiente para realizar a consulta.
404Não encontrado: registro não localizado.
408Tempo esgotado: consulta não foi concluída no prazo.
500Erro interno: falha no processamento da consulta.
503Serviço em manutenção: indisponível temporariamente.

10. Notas Importantes

  • O nome é obrigatório e deve ser exato para obter resultados precisos.
  • As listas SDN e NONSDN são atualizadas frequentemente, garantindo dados recentes.