💡Esta API permite consultar a lista consolidada do Conselho de Segurança da ONU, que inclui indivíduos e entidades sujeitos a sanções. É usada para verificar compliance, evitar riscos e atender às exigências de prevenção à lavagem de dinheiro.
Introdução
A API UNSCCL é essencial para organizações que buscam avaliar riscos e atender às normas internacionais de compliance e ESG. A consulta retorna dados de indivíduos e entidades sancionados pelo Conselho de Segurança da ONU.
URL Base
https://api.directd.com.br
Endpoint
GET /api/UnitedNationsSecurityList
Descrição: Endpoint para realizar consultas na lista consolidada de sanções da ONU.
Nota: Esta consulta não gera comprovantes.
Autenticação
- Obrigatório: Um token válido deve ser fornecido para autenticar as requisições. Para suporte, entre em contato com suporte@directd.com.br.
Campos da API
Sanções
- Nome Consultado: Nome fornecido na consulta.
- Resultados Encontrados: Quantidade de registros correspondentes.
- Lista de Sanções:
- Número do Registro: Identificação única do registro.
- Versão: Versão da lista.
- Nome: Nome do indivíduo ou entidade.
- Sobrenome: Sobrenome, se aplicável.
- Nome na Escrita Original: Nome no idioma original.
- Tipo: Categoria do registro (indivíduo ou entidade).
- Referência: Referência da sanção.
- Observação: Informações adicionais.
- Data de Inclusão: Data em que o nome foi adicionado à lista.
- Sexo: Masculino ou Feminino.
- Data de Nascimento: Data de nascimento do indivíduo.
- Local de Nascimento: Cidade e país de nascimento.
- UN Lista: Regime ou comitê responsável pela inclusão na lista.
- Lista de Designações: Títulos ou posições associadas.
- Lista de Nacionalidades: Países de cidadania.
- Lista de Documentos:
- Documento: Identificação (passaporte, etc.).
- Tipo: Tipo do documento.
- Data de Emissão: Data de emissão do documento.
- Observação: Informações adicionais sobre o documento.
- Lista de Endereços:
- Endereço: Rua ou local de residência.
- Cidade: Localidade.
- Estado: Unidade federativa.
- Código Postal: CEP ou código postal.
- País: País associado.
- Lista de Alcunhas: Apelidos ou nomes alternativos.
- Lista de Títulos: Títulos profissionais ou sociais.
- Lista de Datas de Atualizações: Histórico de modificações na inclusão.
Parâmetros
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
NOME | string | Não | Nome completo do indivíduo ou entidade (maiúsculo ou minúsculo). |
SOBRENOME | string | Não | Sobrenome do indivíduo (maiúsculo ou minúsculo). |
TOKEN | string | Sim | Token de autenticação necessário para realizar a consulta. |
Exemplos de Requisição
Usando cURL
curl 'https://api.directd.com.br/api/UnitedNationsSecurityList?NOME=John&SOBRENOME=Doe&TOKEN=seu_token_aqui'
Respostas
Sucesso (200)
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "UNSCCL - United Nations Security Council Consolidated List",
"consultaUid": "directd-987654321",
"usuario": "Cliente",
"mensagem": "Sucesso",
"apiVersao": "v3",
"tempoExecucaoMs": 1200
},
"retorno": {
"nomeConsultado": "John Doe",
"resultadosEncontrados": 1,
"sancoes": [
{
"numeroRegistro": "UN12345",
"versao": "1.0",
"nome": "John",
"sobrenome": "Doe",
"nomeEscritaOriginal": "جون دو",
"tipo": "Indivíduo",
"referencia": "CSNU-456789",
"observacao": "Envolvido em sanções relacionadas ao terrorismo.",
"dataInclusao": "2020-03-01",
"sexo": "Masculino",
"dataNascimento": "1970-01-15",
"localNascimento": "Bagdá, Iraque",
"unLista": "1267 ISIL (Da'esh) e Al-Qaida Sanctions Committee",
"designacoes": ["Membro do ISIL"],
"nacionalidades": ["Iraquiana"],
"documentos": [
{
"documento": "P1234567",
"tipo": "Passaporte",
"dataEmissao": "2015-05-20",
"observacao": "Emitido em Bagdá."
}
],
"enderecos": [
{
"endereco": "Rua XYZ, 123",
"cidade": "Bagdá",
"estado": "Bagdá",
"codigoPostal": "10001",
"pais": "Iraque"
}
],
"alcunhas": ["Abu Jihad"],
"titulos": ["Comandante"],
"datasAtualizacoes": ["2021-06-15", "2022-03-12"]
}
]
}
}
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. |
404 | Recurso solicitado não encontrado. |
500 | Erro interno: falha no processamento da consulta. |
Notas Importantes
- Use nomes completos para maior precisão na consulta.
- Esta API é uma ferramenta essencial para organizações que lidam com transações internacionais e precisam atender às normas do Conselho de Segurança da ONU.
- Certifique-se de fornecer um token válido para evitar erros de autenticação.