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

# Histórico profissional do titular

> SERVICE_PROFESSIONAL_HISTORY_OWNER_ONLY · Histórico profissional

> [!NOTE]
>
> Alias: `SERVICE_PROFESSIONAL_HISTORY_OWNER_ONLY` · Preço: **R\$ 0,60** por consulta · Exige `purpose`

Histórico profissional

Execute pelo endpoint único [`POST /v1/services`](https://api-docs.omni-ward.com/api-reference/executar-servicos). Você pode combinar este serviço com outros na mesma chamada, enviando cada identificador uma vez.

## Campos do request

| Campo | Obrigatório | Descrição |
| - | - | - |
| `services` | sim | Inclua `"SERVICE_PROFESSIONAL_HISTORY_OWNER_ONLY"` na lista. |
| `cpf` | sim | CPF, com ou sem pontuação. |
| `purpose` | sim | Finalidade do tratamento. Este serviço trata dados pessoais. |
| `birthDate` | não | Data de nascimento, no formato AAAA-MM-DD. |

## Campos em `result`

| Campo | Descrição | Tipo |
| - | - | - |
| `ProfessionData` | Objeto principal de retorno do dataset, contendo as informações consolidadas relacionadas à pessoa consultada. | object |
| `ProfessionData.Professions` | Lista de objetos com os detalhes de cada trabalho encontrado. | array |
| `ProfessionData.Professions[].Source` | Fonte da informação. | string |
| `ProfessionData.Professions[].Sector` | Setor da empresa (PRIVATE / PUBLIC / etc...). | string |
| `ProfessionData.Professions[].City` | Cidade em que a profissão é exercida. | string |
| `ProfessionData.Professions[].State` | Estado em que a profissão é exercida. | string |
| `ProfessionData.Professions[].Country` | País em que a profissão é exercida. | string |
| `ProfessionData.Professions[].CompanyIdNumber` | Número de identificação (CNPJ) da empresa. | string |
| `ProfessionData.Professions[].CompanyName` | Nome da empresa em que o indivíduo trabalha. | string |
| `ProfessionData.Professions[].Area` | Área (marketing, vendas, etc...) da empresa onde a pessoa trabalha. | string |
| `ProfessionData.Professions[].Level` | Cargo ou posição (quando disponível). Valores não padronizados. | string |
| `ProfessionData.Professions[].Status` | ituação empregatícia. (ACTIVE / INACTIVE). | string |
| `ProfessionData.Professions[].IncomeRange` | Faixa salarial estimada proporcionada por esse trabalho. | string |
| `ProfessionData.Professions[].Income` | Renda estimada proporcionada por esse trabalho. | number |
| `ProfessionData.Professions[].Discount` | Valor do desconto relativo aos salários da profissão. | number |
| `ProfessionData.Professions[].Rating` | Rating da pessoa no site (quando disponível). | number |
| `ProfessionData.Professions[].DeclaredSkills` | Lista de habilidades declaradas pela pessoa. | array |
| `ProfessionData.Professions[].DeclaredInterests` | Lista de interesses declarados pela pessoa. | array |
| `ProfessionData.Professions[].StartDate` | Data de início ou admissão no trabalho. | string |
| `ProfessionData.Professions[].EndDate` | Data de término ou desligamento do trabalho. | string |
| `ProfessionData.Professions[].AdditionalDetails` | Objeto com informações adicionais sobre o trabalho. | object |
| `ProfessionData.Professions[].AdditionalDetails.Situation` | Situação administrativa associada ao cargo público (deferido, indeferido, suspenso, etc.). | string |
| `ProfessionData.Professions[].AdditionalDetails.IsDead` | Flag indicando se o servidor público faleceu. | boolean |
| `ProfessionData.Professions[].AdditionalDetails.CompanyAdmissionDate` | Data de admissão na empresa ou órgão público. Pode ser diferente do campo 'StartDate', que se refere ao cargo específico. | string |
| `ProfessionData.Professions[].AdditionalDetails.JobFunction` | Função de trabalho. | string |
| `ProfessionData.Professions[].AdditionalDetails.JobRole` | Cargo desempenhado no trabalho. | string |
| `ProfessionData.Professions[].AdditionalDetails.ServantType` | Tipo do servidor (civil, militar, etc...). | string |
| `ProfessionData.Professions[].AdditionalDetails.WorkLoad` | Carga de trabalho do servidor. | string |
| `ProfessionData.Professions[].AdditionalDetails.WorkingPlace` | Endereço do local de trabalho do servidor. | string |
| `ProfessionData.Professions[].AdditionalDetails.OrganType` | Tipo do orgão em que o servidor trabalha. | string |
| `ProfessionData.Professions[].AdditionalDetails.HeadBranch` | Orgão superior ao qual o cargo está associado. (Ministério da Educação, Ministério da Economia, etc...). | string |
| `ProfessionData.Professions[].AdditionalDetails.IncomeHistory` | Lista de objetos com informações sobre a evolução da renda do servidor no emprego público. | array |
| `ProfessionData.Professions[].AdditionalDetails.IncomeHistory[].Income` | Valor da remuneração. | number |
| `ProfessionData.Professions[].AdditionalDetails.IncomeHistory[].Discount` | Valor do desconto. | number |
| `ProfessionData.Professions[].AdditionalDetails.IncomeHistory[].ReferenceDate` | Data de referência do registro. | string |
| `ProfessionData.Professions[].AdditionalDetails.AverageIncome` | Valor médio da renda ao longo do tempo. | number |
| `ProfessionData.Professions[].AdditionalDetails.MaxIncome` | Valor máximo da renda ao longo do tempo. | number |
| `ProfessionData.Professions[].AdditionalDetails.MinIncome` | Valor mínimo da renda ao longo do tempo. | number |
| `ProfessionData.Professions[].AdditionalDetails.AverageDiscount` | Valor médio dos descontos ao longo do tempo. | number |
| `ProfessionData.Professions[].AdditionalDetails.MaxDiscount` | Valor máximo do desconto ao longo do tempo. | number |
| `ProfessionData.Professions[].AdditionalDetails.MinDiscount` | Valor mínimo do desconto ao longo do tempo. | number |
| `ProfessionData.Professions[].AdditionalDetails.Category` | Categoria do trabalho. | string |
| `ProfessionData.Professions[].AdditionalDetails.RNTRC` | Registro Nacional de Transportadores Rodoviários de Cargas. | string |
| `ProfessionData.Professions[].AdditionalDetails.RegistrationNumber` | Número de matrícula do servidor. | string |
| `ProfessionData.Professions[].AdditionalDetails.TerminationDate` | Data em que o servidor foi desligado do cargo. | string |
| `ProfessionData.Professions[].CreationDate` | Data em que este registro foi criado. | string |
| `ProfessionData.Professions[].LastUpdateDate` | Data da última atualização deste registro. | string |
| `ProfessionData.TotalProfessions` | Número total de profissões exercidas. | integer |
| `ProfessionData.TotalActiveProfessions` | Número total de profissões em exercício. | integer |
| `ProfessionData.TotalIncome` | Total de renda calculada para o indivíduo, como um valor fixado. | number |
| `ProfessionData.TotalIncomeRange` | Valor estimado da faixa de renda do indivíduo. | string |
| `ProfessionData.TotalDiscounts` | Total de descontos em relação aos salários do indivíduo. | number |
| `ProfessionData.IsEmployed` | Indica se a pessoa está empregada ou não. | boolean |

Todo `result` traz também `outcome`, o resumo da consulta: `clear`, `alert`, `match`, `no_match` ou `not_found`.

```bash cURL theme={null}
curl --request POST 'https://api.omni-ward.com/v1/services' \
  --header 'Authorization: Bearer $OMNI_WARD_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: $(uuidgen)' \
  --data '{
  "services": [
    "SERVICE_PROFESSIONAL_HISTORY_OWNER_ONLY"
  ],
  "cpf": "00000000000",
  "purpose": "Abertura de conta"
}'
```

```javascript Node.js theme={null}
const res = await fetch('https://api.omni-ward.com/v1/services', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.OMNI_WARD_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    "services": [
      "SERVICE_PROFESSIONAL_HISTORY_OWNER_ONLY"
    ],
    "cpf": "00000000000",
    "purpose": "Abertura de conta"
  }),
});
const { results } = await res.json();
```

```python Python theme={null}
import os, uuid, requests

res = requests.post(
    "https://api.omni-ward.com/v1/services",
    headers={"Authorization": f"Bearer {os.environ['OMNI_WARD_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    json={
      "services": [
        "SERVICE_PROFESSIONAL_HISTORY_OWNER_ONLY"
      ],
      "cpf": "00000000000",
      "purpose": "Abertura de conta"
    },
    timeout=90,
)
results = res.json()["results"]
```

```php PHP theme={null}
$ch = curl_init("https://api.omni-ward.com/v1/services");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("OMNI_WARD_API_KEY"),
    "Content-Type: application/json",
    "Idempotency-Key: " . bin2hex(random_bytes(16)),
  ],
  CURLOPT_POSTFIELDS => '{"services":["SERVICE_PROFESSIONAL_HISTORY_OWNER_ONLY"],"cpf":"00000000000","purpose":"Abertura de conta"}',
]);
$results = json_decode(curl_exec($ch), true)["results"];
```

```java Java theme={null}
var body = """
    {
      "services": [
        "SERVICE_PROFESSIONAL_HISTORY_OWNER_ONLY"
      ],
      "cpf": "00000000000",
      "purpose": "Abertura de conta"
    }
    """;
var request = HttpRequest.newBuilder(URI.create("https://api.omni-ward.com/v1/services"))
    .header("Authorization", "Bearer " + System.getenv("OMNI_WARD_API_KEY"))
    .header("Content-Type", "application/json")
    .header("Idempotency-Key", UUID.randomUUID().toString())
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
```

```json 200 theme={null}
{
  "results": [
    {
      "service": "SERVICE_PROFESSIONAL_HISTORY_OWNER_ONLY",
      "status": {
        "code": 200,
        "message": "Success"
      },
      "result": {
        "ProfessionData": {
          "Professions": [
            {
              "Source": "RAIS",
              "Sector": "PUBLIC - 8411600 - ADMINISTRACAO PUBLICA EM GERAL",
              "Country": "BRAZIL",
              "CompanyIdNumber": "779********121",
              "CompanyName": "TRI********************************ANA",
              "Area": "UNKNOWN",
              "Level": "EMPLOYEE",
              "Status": "ACTIVE",
              "IncomeRange": "4 A 10 SM",
              "Income": 7000,
              "StartDate": "1993-03-08T00:00:00Z",
              "EndDate": "9999-12-31T23:59:59.9999999",
              "CreationDate": "2018-02-12T00:00:00Z",
              "LastUpdateDate": "2024-01-18T00:00:00Z"
            }
          ],
          "TotalProfessions": 1,
          "TotalActiveProfessions": 1,
          "TotalIncome": 7000,
          "TotalIncomeRange": "4 A 10 SM",
          "TotalDiscounts": 0,
          "IsEmployed": true
        },
        "outcome": "clear"
      },
      "simulated": false,
      "costMinor": 60
    }
  ],
  "totalCostMinor": 60
}
```

```json 422 theme={null}
{
  "error": {
    "code": "validation_failed",
    "message": "Alguns serviços não podem ser executados. Nada foi consultado nem cobrado.",
    "correlationId": "4f1c9a7e-2b1d-4c55-9a51-0d2f6f1c2a10",
    "details": {
      "results": [
        {
          "service": "SERVICE_PROFESSIONAL_HISTORY_OWNER_ONLY",
          "status": {
            "code": 422,
            "message": "Validation failed"
          },
          "result": null,
          "errors": [
            {
              "field": "cpf",
              "code": "required",
              "message": "Informe CPF: este serviço exige o campo."
            }
          ]
        }
      ]
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.