# Lista Consolidada da ONU

> Permite consultar a Lista Consolidada da ONU para verificar indivíduos e entidades sujeitos a sanções internacionais, facilitando verificações de compliance em AML/KYC e análise de risco.

- **Consulta:** `onu-sancoes`
- **Categoria:** Internacional
- **Preço:** R$ 0,51 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/onu-sancoes`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/internacional/onu-sancoes

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Este endpoint consulta a Lista Consolidada do Conselho de Segurança das Nações Unidas, que reúne indivíduos e entidades submetidos a sanções internacionais. Permite identificar pessoas e organizações sujeitas a restrições impostas pela ONU, essencial para operações de conformidade e gestão de riscos.
>
> É utilizado em fluxos de Know Your Customer (KYC), triagem de compliance, detecção de pessoas politicamente expostas (PEP) e análise de risco em processos de onboarding de clientes e fornecedores. Mitiga exposições regulatórias, reputacionais e operacionais ao consultar uma cobertura internacional de listas de sanções.

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/onu-sancoes?nome=SEU_NOME"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/onu-sancoes",
    params={"nome": "SEU_NOME"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/onu-sancoes");

url.search = new URLSearchParams({
  "nome": "SEU_NOME"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `nome` | texto | sim | Nome completo para busca | formato: Nome completo |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A resposta retorna os seguintes campos:
>
> **Metadados da consulta:**
> - `consultaNome`: Nome consultado
> - `consultaUid`: Identificador único da consulta
> - `resultadoId`: Código do resultado
> - `resultado`: Status textual da operação
> - `mensagem`: Descrição da resposta
> - `data`: Timestamp da consulta
> - `tempoExecucaoMs`: Latência de processamento
>
> **Dados de sanções (array `sancoes`):**
> - `numeroRegistro`, `versao`: Identificação do registro
> - `nome`, `sobrenome`: Dados pessoais
> - `nomeEscritaOriginal`: Nome em grafia original
> - `tipo`: Classificação do registro
> - `dataNascimento`, `localNascimento`: Dados biográficos
> - `sexo`: Gênero do indivíduo
> - `unLista`: Lista específica da ONU em que consta
> - `dataInclusao`: Data de inclusão na lista
> - `designacoes`: Array de designações atribuídas
> - `nacionalidades`: Array de nacionalidades
> - `documentos`: Array contendo documento, tipo, data de emissão e observações
> - `enderecos`: Array com endereço, cidade, estado, código postal e país
> - `alcunhas`: Alias ou nomes alternativos
> - `titulos`: Títulos associados
> - `datasAtualizacoes`: Histórico de datas de atualização
> - `observacao`: Notas relevantes ao registro
> - `referencia`: Dados de referência do registro
>
> **Resumo dos resultados:**
> - `resultadosEncontrados`: Quantidade de registros encontrados
> - `nomeConsultado`: Nome que foi objeto da busca
> - `observacoes`: Observações gerais sobre a consulta

### Exemplo de resposta

```json
{
  "consta": "boolean",
  "mensagem": "string",
  "parametros": {
    "nome": "string"
  }
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "retorno": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "sancoes": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "object",
            "properties": {
              "nome": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Nome do indivíduo ou entidade."
              },
              "sexo": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Gênero do indivíduo."
              },
              "tipo": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Tipo do registro."
              },
              "versao": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Versão do registro."
              },
              "titulos": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "description": "Títulos associados."
              },
              "unLista": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Lista em que o indivíduo está citado."
              },
              "alcunhas": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "description": "Alcunhas ou apelidos."
              },
              "enderecos": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "object",
                  "properties": {
                    "pais": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "País do endereço."
                    },
                    "cidade": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Cidade do endereço."
                    },
                    "estado": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Estado do endereço."
                    },
                    "endereco": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Endereço completo."
                    },
                    "codigoPostal": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Código postal."
                    }
                  }
                },
                "description": "Endereços registrados."
              },
              "sobrenome": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Sobrenome do indivíduo."
              },
              "documentos": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "object",
                  "properties": {
                    "tipo": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Tipo do documento."
                    },
                    "documento": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Número do documento."
                    },
                    "observacao": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Observações sobre o documento."
                    },
                    "dataEmissao": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Data de emissão do documento."
                    }
                  }
                },
                "description": "Documentos associados."
              },
              "observacao": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Observações específicas do registro."
              },
              "referencia": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Dados de referência do registro."
              },
              "designacoes": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "description": "Designações associadas."
              },
              "dataInclusao": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Data de inclusão na lista."
              },
              "dataNascimento": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Data de nascimento."
              },
              "nacionalidades": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "description": "Nacionalidades do indivíduo."
              },
              "numeroRegistro": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Número de registro do indivíduo ou entidade."
              },
              "localNascimento": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Local de nascimento."
              },
              "datasAtualizacoes": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "description": "Datas das atualizações do registro."
              },
              "nomeEscritaOriginal": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Nome na escrita original."
              }
            }
          },
          "description": "Lista de sanções encontradas."
        },
        "observacoes": {
          "type": [
            "string",
            "null"
          ],
          "description": "Observações gerais da consulta."
        },
        "nomeConsultado": {
          "type": [
            "string",
            "null"
          ],
          "description": "Nome consultado."
        },
        "resultadosEncontrados": {
          "type": [
            "number",
            "null"
          ],
          "description": "Quantidade de resultados encontrados."
        }
      },
      "description": "Dados de retorno da consulta."
    },
    "metaDados": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "ip": {
          "type": [
            "string",
            "null"
          ],
          "description": "Endereço IP da requisição."
        },
        "data": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data e hora da consulta."
        },
        "chave": {
          "type": [
            "string",
            "null"
          ],
          "description": "Chave da consulta."
        },
        "usuario": {
          "type": [
            "string",
            "null"
          ],
          "description": "Usuário que realizou a consulta."
        },
        "mensagem": {
          "type": [
            "string",
            "null"
          ],
          "description": "Mensagem informativa da consulta."
        },
        "apiVersao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Versão da API utilizada."
        },
        "resultado": {
          "type": [
            "string",
            "null"
          ],
          "description": "Status do resultado da consulta."
        },
        "assincrono": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica se a consulta foi processada de forma assíncrona."
        },
        "consultaUid": {
          "type": [
            "string",
            "null"
          ],
          "description": "Identificador único da consulta."
        },
        "resultadoId": {
          "type": [
            "number",
            "null"
          ],
          "description": "Identificador do resultado."
        },
        "consultaNome": {
          "type": [
            "string",
            "null"
          ],
          "description": "Nome consultado na requisição."
        },
        "enviarCallback": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica se deve enviar callback."
        },
        "urlComprovante": {
          "type": [
            "string",
            "null"
          ],
          "description": "URL do comprovante gerado."
        },
        "tempoExecucaoMs": {
          "type": [
            "number",
            "null"
          ],
          "description": "Tempo de execução em milissegundos."
        },
        "gerarComprovante": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica se deve gerar comprovante."
        }
      },
      "description": "Metadados da requisição e resposta."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - Cada consulta retorna zero ou mais registros de sanções, permitindo identificar correspondências completas ou parciais.
> - Um indivíduo ou entidade pode estar associado a múltiplos regimes de sanção e critérios de inclusão.
> - Os dados retornados incluem histórico de atualizações e múltiplas formas de identificação, facilitando a reconciliação com bases internas.
> - A documentação mantém-se atualizada com as publicações oficiais dos regimes de sanção.
> - Recomenda-se consultar também os títulos, alcunhas e designações para aumentar a precisão da triagem.
> - Esta consulta é síncrona — o resultado é retornado na mesma requisição.
> - Suporte disponível em caso de dúvidas sobre utilização ou interpretação dos resultados.

---

Página em HTML: https://fontedata.com/docs/internacional/onu-sancoes
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp