Histórico profissional
Ocupação, vínculos profissionais e renda estimada de uma pessoa, com empresa, setor e período.
Quando usar
Análise de crédito
Confirme vínculo empregatício e estabilidade de renda.
Contratação
Confira a trajetória informada no currículo.
Como funciona
Fluxo assíncrono
- 1POSTCriar consulta
Envia o documento e recebe o requestId na hora.
- 2GETAcompanhar
Repete a chamada com o requestId enquanto o status for pending.
- 3GETBuscar resultado
Com status done, o resultado completo vem em data.
Como acompanhar o resultado
Repita o GET a cada 2 ou 3 segundos até o status ser done ou error. A maioria das consultas termina em poucos segundos.
Passo 1
Criar consulta
/api/partner/v2/people/occupationCriar consulta de ocupação (CPF).
Corpo da requisição
documentstringobrigatórioCPF com 11 dígitos (apenas números)
Respostas
- 200Solicitação criada com sucesso
curl -X POST "https://consultadeprocessos.com.br/api/partner/v2/people/occupation" \
-H "Authorization: Bearer SUA_CHAVE_DE_API" \
-H "Content-Type: application/json" \
-d '{"document":"12345678901"}'{
"requestId": "cm8p1q2r30004ab12cdef5678",
"message": "Solicitação realizada com sucesso"
}Passo 2
Buscar resultado
/api/partner/v2/people/occupation/{requestId}Consultar resultado de ocupação (CPF).
Parâmetros do caminho
requestIdstringno caminhoobrigatório
Respostas
- 200Resultado da solicitação
curl -X GET "https://consultadeprocessos.com.br/api/partner/v2/people/occupation/cm8p1q2r30004ab12cdef5678" \
-H "Authorization: Bearer SUA_CHAVE_DE_API"{
"data": {
"document": "12345678901",
"isEmployed": true,
"totalIncome": 6000,
"totalDiscounts": null,
"totalIncomeRange": "4 A 10 SM",
"totalProfessions": 2,
"totalActiveProfessions": 1,
"professions": [
{
"id": "cm8r4s5t60007ab12cdef3456",
"area": "UNKNOWN",
"level": "EMPLOYEE",
"income": 6000,
"sector": "PRIVATE - 8211300 - SERVICOS COMBINADOS DE ESCRITORIO E APOIO ADMINISTRATIVO",
"source": "RAIS",
"status": "ACTIVE",
"country": "BRAZIL",
"startDate": "2021-03-01T00:00:00.000Z",
"endDate": null,
"companyName": "EMPRESA EXEMPLO SERVICOS LTDA",
"incomeRange": "4 A 10 SM",
"creationDate": "2021-05-12T00:00:00.000Z",
"lastUpdateDate": "2026-07-20T00:00:00.000Z",
"companyIdNumber": "12345678000190"
},
{
"id": "cm8r4s5t60008ab12cdef7890",
"area": "UNKNOWN",
"level": "ENTREPRENEUR | BUSINESS OWNER",
"income": 0,
"sector": "PRIVATE - 4781400 - COMERCIO VAREJISTA DE ARTIGOS DO VESTUARIO E ACESSORIOS",
"source": "RECEITA FEDERAL",
"status": "INACTIVE",
"country": "BRAZIL",
"startDate": "2016-08-15T00:00:00.000Z",
"endDate": "2020-12-31T00:00:00.000Z",
"companyName": "LOJA MODELO COMERCIO DE ROUPAS LTDA",
"incomeRange": "SEM INFORMACAO",
"creationDate": "2016-09-01T00:00:00.000Z",
"lastUpdateDate": "2021-01-15T00:00:00.000Z",
"companyIdNumber": "98765432000110"
}
],
"createdAt": "2026-09-30T14:22:10.000Z",
"updatedAt": "2026-09-30T14:22:10.000Z"
},
"status": "done"
}O que a resposta traz
Resumo
- Situação de emprego atual
isEmployed - Vínculos totais e ativos
totalProfessions · totalActiveProfessions - Renda estimada e faixa de renda
totalIncome · totalIncomeRangeFaixa em salários mínimos, como 4 A 10 SM.
- Descontos
totalDiscounts - Separação entre vínculos CLT e participação em empresasSó no painel
Em cada vínculo
- Empresa e CNPJ
professions[].companyName · companyIdNumber - Nível
levelEmpregado, sócio ou proprietário, autônomo.
- Setor
sectorPrivado, público ou misto, com CNAE e atividade da empresa.
- Área
area - Renda e faixa de renda
income · incomeRange - Status
statusAtivo (ACTIVE) ou inativo (INACTIVE).
- Início e fim
startDate · endDate - Origem do registro
sourceRAIS para vínculos CLT, Receita Federal para sociedades.
- País
country - Tempo de cada vínculoSó no painel
Valores por plano
| Plano mensal | Valor da consulta |
|---|---|
Sob demanda | R$ 5,00 |
R$ 100/mês até 47 consultas | R$ 2,10 |
R$ 300/mês até 166 consultas | R$ 1,80 |
R$ 500/mês até 294 consultas | R$ 1,70 |
R$ 1.000/mês até 625 consultas | R$ 1,60 |
R$ 3.000/mês até 2.068 consultas | R$ 1,45 |
R$ 10.000/mês até 7.575 consultas | R$ 1,32 |
R$ 20.000/mês até 16.000 consultas | R$ 1,25 |
O valor é cobrado por consulta, na criação da consulta. Ler o resultado de novo pelo mesmo requestId não gera nova cobrança.
Sem plano, a conta usa o valor Sob demanda e paga só o que consumir.
Comparar planosPróximos passos
Autenticação
Gere a chave e envie no cabeçalho.
Erros e códigos
Como tratar cada resposta de erro.
Cobrança e reembolso
Quando cobramos e quando o valor volta.
Dados cadastrais CPF
Nome, data de nascimento, filiação e situação cadastral de uma pessoa pelo CPF.
Dados cadastrais CNPJ
Razão social, situação cadastral, CNAE, natureza jurídica e capital social de uma empresa pelo CNPJ.
Telefones
Telefones vinculados a um CPF, com tipo, operadora e indicação de qual é o principal.