💡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:
- O token deve ser enviado como parâmetro na URL da requisição.
- 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
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
NOME | string | Sim | Nome da pessoa ou entidade a ser consultada. |
SOBRENOME | string | Não | Sobrenome da pessoa a ser consultada. |
TOKEN | string | Sim | Token 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ódigo | Descrição |
---|---|
400 | Requisição inválida: parâmetros incorretos. |
401 | Não autenticado: token inválido ou ausente. |
403 | Não autorizado: saldo insuficiente para realizar a consulta. |
404 | Não encontrado: registro não localizado. |
408 | Tempo esgotado: consulta não foi concluída no prazo. |
500 | Erro interno: falha no processamento da consulta. |
503 | Serviç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.