> ## Documentation Index
> Fetch the complete documentation index at: https://docs.proteodata.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# KYC familiares de 1º nível PF

> Slug cpf-kyc-relatives, escopo familiar, autenticação, corpo, resposta e preços

Este produto expõe consulta de **KYC e compliance dos familiares de primeiro nível** de pessoa física (mãe, pai, irmãos e filhos), a partir do CPF do titular consultado.

## O que esperar do produto (escopo em alto nível)

O retorno concentra sinais agregados e registros individuais relacionados aos familiares identificados, incluindo dados análogos ao KYC individual (PEP, sanções e restrições, quando houver na origem).

Os campos concretos vêm em `data` e podem evoluir na origem. Modele a integração como JSON dinâmico e valide somente os campos que sua aplicação realmente consome.

## Faixas de preço de referência (origem)

Faixas publicadas para o dataset técnico `first_level_relatives_kyc`:

| Volume mensal         | Valor por consulta              |
| --------------------- | ------------------------------- |
| 1 a 10.000            | R\$ 0,130                       |
| 10.001 a 50.000       | R\$ 0,124                       |
| 50.001 a 100.000      | R\$ 0,118                       |
| 100.001 a 500.000     | R\$ 0,112                       |
| 500.001 a 1.000.000   | R\$ 0,106                       |
| 1.000.001 a 5.000.000 | faixa contratual fixa na origem |
| 5.000.001+            | sob negociação                  |

> A cobrança final na Proteo Data aparece em `meta.chargedCredits` conforme seu plano/contrato.

## Contrato único da Proteo Data

* Autenticação por API key no header `Authorization: Bearer`.
* Corpo mínimo com `document` (CPF de 11 dígitos, apenas números).
* Uma entidade por chamada.

## Endpoint

`POST /v1/query/cpf-kyc-relatives`

## Autenticação

`Authorization: Bearer <sua_api_key>`

## Corpo da requisição

```json theme={null}
{
  "document": "00000000000"
}
```

## Concorrência e desempenho

Chamadas simultâneas para mesmo produto + mesmo `document` podem ser consolidadas internamente; cada resposta mantém seu `meta.queryId` e `meta.chargedCredits`.

## Resposta de sucesso (`200`)

```json theme={null}
{
  "data": {
    "MatchKeys": "doc{417***5008}",
    "FirstLevelRelativesKycData": {
      "HasRelativesWithSanctions": false,
      "HasRelativesWhoAreCurrentlyPEP": false,
      "Relatives": []
    }
  },
  "meta": {
    "chargedCredits": "0.291200",
    "product": "cpf-kyc-relatives",
    "queryId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}
```

## Erros comuns

`400`, `401`, `402`, `404` e `502`, seguindo o mesmo contrato de [Erros e limites](/dev/erros-e-limites).

## Privacidade e tratamento de dados

Como envolve dados de pessoa física e familiares, aplique base legal adequada, minimização e controles de retenção/acesso conforme LGPD e política interna.

## Exemplos prontos

Use [Primeira consulta](/dev/primeira-consulta) com `SLUG_DO_PRODUTO` = `cpf-kyc-relatives`.

## Referência OpenAPI

Na aba Referência da API: `POST /v1/query/cpf-kyc-relatives`.

## Documentação da origem

* [KYC e Compliance dos Familiares de Primeiro Nível](https://docs.bigdatacorp.com.br/plataforma/reference/pessoas-kyc-e-compliance-familiares-primeiro-nivel)