💡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

NomeTipoObrigatórioDescrição
NOMEstringNãoNome completo do indivíduo ou entidade (maiúsculo ou minúsculo).
SOBRENOMEstringNãoSobrenome do indivíduo (maiúsculo ou minúsculo).
TOKENstringSimToken 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ódigoDescrição
400Requisição inválida: parâmetros incorretos.
401Não autenticado: token inválido ou ausente.
403Não autorizado: saldo insuficiente.
404Recurso solicitado não encontrado.
500Erro interno: falha no processamento da consulta.

Notas Importantes

  1. Use nomes completos para maior precisão na consulta.
  2. 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.
  3. Certifique-se de fornecer um token válido para evitar erros de autenticação.