KYC e Sanções
O serviço de Sanções e Restrições retorna informações sobre sanções e restrições aplicadas à entidade consultada e seus sócios, com abrangência nacional e internacional.
Quando usar
Descrição
O serviço de KYC e Sanções fornece dados detalhados sobre sanções e restrições aplicadas à entidade consultada e seus sócios, incluindo registros atuais e históricos em âmbito nacional e internacional.
Essas informações são essenciais para processos de compliance, análise de risco e atendimento a requisitos regulatórios.
Requisição
Autenticação por chave de API (cabeçalho Authorization: Bearer), criada no painel com esta consulta no escopo.
POST /api/v1/{tenant}/empresas/kyc-e-sancoes-pj
| Campo | Obrigatório | Descrição |
|---|---|---|
document |
sim | CNPJ da empresa, com ou sem máscara. |
{
"document": "00.000.000/0000-00"
}
Campos de retorno
Campos dentro de data. [] indica lista.
| Campo | Tipo |
|---|---|
SanctionsNational[].description |
texto |
SanctionsNational[].source_count |
número |
SanctionsNational[].sanctions[].type |
texto |
SanctionsNational[].sanctions[].motive |
texto |
SanctionsNational[].sanctions[].created_at |
texto |
SanctionsNational[].sanctions[].updated_at |
texto |
SanctionsInternational[].description |
texto |
SanctionsInternational[].source_count |
número |
SanctionsInternational[].sanctions[].type |
texto |
SanctionsInternational[].sanctions[].motive |
texto |
SanctionsInternational[].sanctions[].created_at |
texto |
SanctionsInternational[].sanctions[].updated_at |
texto |
SanctionsInternational[].sanctions[].start_date |
texto |
SanctionsInternational[].sanctions[].end_date |
texto |
SanctionsInternational[].sanctions[].match_rate |
número |
SanctionsNationalOutros[].sanctions[].type |
texto |
SanctionsNationalOutros[].sanctions[].motive |
texto |
SanctionsNationalOutros[].sanctions[].created_at |
texto |
SanctionsNationalOutros[].sanctions[].updated_at |
texto |
SanctionsNationalOutros[].description |
texto |
SanctionsNationalOutros[].source_count |
número |
SanctionsList[].target |
texto |
SanctionsList[].description |
texto |
SanctionsList[].sanctions_count |
número |
SanctionsCount |
número |
SanctionListsCount |
número |
SanctionFlags.cvm |
booleano |
SanctionFlags.banco_central |
booleano |
SanctionFlags.ibama |
booleano |
SanctionFlags.cnj |
booleano |
SanctionFlags.tcu |
booleano |
SanctionFlags.cgu |
booleano |
SanctionFlags.bsm |
booleano |
SanctionFlags.bank_hindered_suppliers |
booleano |
SanctionFlags.tce_sp |
booleano |
SanctionFlags.seape_df |
booleano |
SanctionFlags.coaf |
booleano |
SanctionFlags.ceaf |
booleano |
SanctionFlags.cnep |
booleano |
SanctionFlags.mte |
booleano |
SanctionFlags.ceis |
booleano |
SanctionFlags.cepim |
booleano |
SanctionFlags.interpol |
booleano |
SanctionFlags.fbi |
booleano |
SanctionFlags.ofac |
booleano |
SanctionFlags.govuk |
booleano |
SanctionFlags.eu |
booleano |
SanctionFlags.unsc |
booleano |
SanctionFlags.canada_sanctions |
booleano |
Exemplo de resposta
Estrutura real da resposta, com valores fictícios.
{
"execution_id": "00000000-0000-0000-0000-000000000000",
"status": "success",
"message": "Consulta realizada com sucesso",
"query_name": "KYC e Sanções",
"query_slug": "kyc-e-sancoes-pj",
"data": {
"SanctionsNational": [
{
"description": "texto",
"source_count": 0,
"sanctions": [
{
"type": "texto",
"motive": "texto",
"created_at": "texto",
"updated_at": "texto"
}
]
}
],
"SanctionsInternational": [
{
"description": "texto",
"source_count": 0,
"sanctions": [
{
"type": "texto",
"motive": "texto",
"created_at": "texto",
"updated_at": "texto",
"start_date": "texto",
"end_date": "texto",
"match_rate": 0
}
]
}
],
"SanctionsNationalOutros": [
{
"sanctions": [
{
"type": "texto",
"motive": "texto",
"created_at": "texto",
"updated_at": "texto"
}
],
"description": "texto",
"source_count": 0
}
],
"SanctionsList": [
{
"target": "texto",
"description": "texto",
"sanctions_count": 0
}
],
"SanctionsCount": 0,
"SanctionListsCount": 0,
"SanctionFlags": {
"cvm": false,
"banco_central": false,
"ibama": false,
"cnj": false,
"tcu": false,
"cgu": false,
"bsm": false,
"bank_hindered_suppliers": false,
"tce_sp": false,
"seape_df": false,
"coaf": false,
"ceaf": false,
"cnep": false,
"mte": false,
"ceis": false,
"cepim": false,
"interpol": false,
"fbi": false,
"ofac": false,
"govuk": false,
"eu": false,
"unsc": false,
"canada_sanctions": false
},
"OutrasListasAtivas": [
]
},
"consulted_at": "2026-01-01T12:00:00Z",
"query_cost": "0.100"
}
Cobrança e respostas
- O valor é cobrado por consulta bem-sucedida.
- 200 — consulta processada (veja status no corpo da resposta)
- 401 — token ausente, inválido, inativo ou expirado
- 403 — serviço fora do escopo da chave, IP não autorizado ou limite de consumo excedido
- 422 — campo obrigatório ausente/inválido ou payload acima do limite do serviço
- 429 — limite de requisições por minuto da chave excedido
- 504 — tempo máximo de execução do serviço excedido