# KYC e Sanções

O serviço Know-Your-Customer (KYC) retorna informações sobre pessoas politicamente expostas (PEP), sanções e restrições, com cobertura nacional e internacional.

- **Identificador:** `pessoas/kyc-e-sancoes`
- **Categoria:** PEP, sanções e compliance
- **Audiência:** PF
- **Endpoint:** `POST /api/v1/{tenant}/pessoas/kyc-e-sancoes`
- **Preço de tabela:** R$ 0,100 por consulta bem-sucedida
- **Página:** https://www.proteo.com.br/api/consultas/pessoas/kyc-e-sancoes

## Quando usar

Descrição

O serviço de KYC e Sanções fornece informações abrangentes para atender às exigências regulatórias e legais de know-your-customer.

Ele retorna dados sobre pessoas politicamente expostas (PPE ou PEP), sanções e restrições, com cobertura nacional e internacional.

Também são incluídas flags que indicam se o indivíduo é PEP ou possui alguma restrição associada, além dos registros históricos dessas situações.

O serviço ainda contempla o conceito de PEP Estendido, que relaciona a pessoa a outros PEPs por vínculos familiares ou outros tipos de relacionamento.

O retorno indica separadamente se a pessoa é PEP direto, PEP indireto e PEP geral (Sim quando qualquer um dos dois é Sim).

## Parâmetros (corpo JSON)

| Campo | Obrigatório | Descrição |
|---|---|---|
| `document` | sim | CPF da pessoa, com ou sem máscara. |

## Campos de retorno (`data`)

| Campo | Tipo |
|---|---|
| `SanctionsNationalOutros[].description` | texto |
| `SanctionsNationalOutros[].source_count` | número |
| `SanctionsNationalOutros[].sanctions[].type` | texto |
| `SanctionsNationalOutros[].sanctions[].motive` | texto |
| `SanctionsNationalOutros[].sanctions[].created_at` | texto |
| `SanctionsNationalOutros[].sanctions[].updated_at` | texto |
| `SanctionsNationalOutros[].sanctions[].start_date` | texto |
| `SanctionsNationalOutros[].sanctions[].end_date` | texto |
| `SanctionsNationalOutros[].sanctions[].match_rate` | número |
| `SanctionsNational[].description` | texto |
| `SanctionsNational[].source_count` | número |
| `SanctionsInternational[].description` | texto |
| `SanctionsInternational[].source_count` | número |
| `SanctionsList[].description` | texto |
| `SanctionsList[].target` | texto |
| `SanctionsList[].sanctions_count` | número |
| `Sanctions[].Source` | texto |
| `Sanctions[].Type` | texto |
| `Sanctions[].StandardizedSanctionType` | texto |
| `Sanctions[].MatchRate` | número |
| `Sanctions[].StartDate` | data |
| `Sanctions[].EndDate` | data |
| `IsCurrentlyPEP` | booleano |
| `PepDirect` | texto |
| `PepIndirect` | texto |
| `PepGeneral` | texto |

## Exemplo de resposta (valores fictícios)

```json
{
  "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",
  "data": {
    "SanctionsNationalOutros": [
      {
        "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
          }
        ]
      }
    ],
    "SanctionsNational": [
      {
        "description": "texto",
        "source_count": 0,
        "sanctions": [

        ]
      }
    ],
    "SanctionsInternational": [
      {
        "description": "texto",
        "source_count": 0,
        "sanctions": [

        ]
      }
    ],
    "SanctionsList": [
      {
        "description": "texto",
        "target": "texto",
        "sanctions_count": 0
      }
    ],
    "Sanctions": [
      {
        "Source": "texto",
        "Type": "texto",
        "StandardizedSanctionType": "texto",
        "MatchRate": 0,
        "StartDate": "2026-01-01",
        "EndDate": "2026-01-01"
      }
    ],
    "PEPHistory": [

    ],
    "IsCurrentlyPEP": false,
    "PepDirect": "texto",
    "PepIndirect": "texto",
    "PepGeneral": "texto"
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "0.100"
}
```