# Turnover

O serviço de Turnover retorna dados sobre a rotatividade profissional da entidade consultada, com foco em aspectos temporais e qualitativos.

- **Identificador:** `pessoas/turnover`
- **Categoria:** Dados cadastrais
- **Audiência:** PF
- **Endpoint:** `POST /api/v1/{tenant}/pessoas/turnover`
- **Preço de tabela:** R$ 0,100 por consulta bem-sucedida
- **Página:** https://www.proteo.com.br/api/consultas/pessoas/turnover

## Quando usar

Descrição

O serviço de Turnover fornece informações agregadas de dados relacionados à rotatividade profissional da entidade consultada, enfatizando características temporais e qualitativas.

## 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 |
|---|---|
| `AvgYearsBetweenProfessionalTurnover` | texto |
| `MaxYearsBetweenProfessionalTurnover` | texto |
| `MinYearsBetweenProfessionalTurnover` | texto |
| `TotalProfessionalTurnover` | número |
| `TotalProfessionalTurnoverIn15Years` | número |
| `TotalProfessionalTurnoverIn10Years` | número |
| `TotalProfessionalTurnoverIn5Years` | número |
| `CompaniesWorkedFor[]` | texto |
| `AgeOfFirstJob` | número |
| `FirstJobAdmissionDate` | data |
| `IsCurrentlyEmployed` | booleano |
| `IsEntrepeneur` | booleano |
| `HasWorkedInPublicSector` | booleano |
| `HasWorkedInPrivateSector` | booleano |

## Exemplo de resposta (valores fictícios)

```json
{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Turnover",
  "query_slug": "turnover",
  "data": {
    "AvgYearsBetweenProfessionalTurnover": "texto",
    "MaxYearsBetweenProfessionalTurnover": "texto",
    "MinYearsBetweenProfessionalTurnover": "texto",
    "TotalProfessionalTurnover": 0,
    "TotalProfessionalTurnoverIn15Years": 0,
    "TotalProfessionalTurnoverIn10Years": 0,
    "TotalProfessionalTurnoverIn5Years": 0,
    "CompaniesWorkedFor": [
      "texto"
    ],
    "AgeOfFirstJob": 0,
    "FirstJobAdmissionDate": "2026-01-01",
    "IsCurrentlyEmployed": false,
    "IsEntrepeneur": false,
    "HasWorkedInPublicSector": false,
    "HasWorkedInPrivateSector": false
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "0.100"
}
```