Histórico Escolar e Acadêmico
O serviço de Histórico Escolar e Acadêmico retorna dados sobre o histórico de educação formal e produções acadêmicas, incluindo nível de escolaridade e publicações.
Quando usar
Descrição
O serviço de Histórico Escolar e Acadêmico fornece informações consolidadas sobre a trajetória educacional e acadêmica de uma pessoa, como nível máximo de escolaridade, cursos universitários, instituições de ensino frequentadas, além do histórico de publicações identificadas.
Parte das informações de escolaridade pode ser inferida por fontes públicas como ENADE e ProUni ou estimativas do IBGE, podendo haver divergências em relação à realidade.
Em casos de inferência, o campo da instituição detalha a origem da informação.
Requisição
Autenticação por chave de API (cabeçalho Authorization: Bearer), criada no painel com esta consulta no escopo.
POST /api/v1/{tenant}/pessoas/historico-escolar-e-academico
| Campo | Obrigatório | Descrição |
|---|---|---|
document |
sim | CPF da pessoa, com ou sem máscara. |
{
"document": "000.000.000-00"
}
Campos de retorno
Campos dentro de data. [] indica lista.
| Campo | Tipo |
|---|---|
ScholarshipHistory[].Level |
texto |
ScholarshipHistory[].Institution |
texto |
ScholarshipHistory[].SpecializationArea |
texto |
ScholarshipHistory[].StartYear |
texto |
ScholarshipHistory[].EndYear |
texto |
ScholarshipHistory[].EducationalLevel |
texto |
ScholarshipLevel |
texto |
EducationalLevel |
texto |
NumberOfUndergraduateCourses |
número |
IsUniversityStudent |
booleano |
IsCurrentlyOnAcademicField |
booleano |
CreationDate |
data |
LastUpdateDate |
data |
Exemplo de resposta
Estrutura real da resposta, com valores fictícios.
{
"execution_id": "00000000-0000-0000-0000-000000000000",
"status": "success",
"message": "Consulta realizada com sucesso",
"query_name": "Histórico Escolar e Acadêmico",
"query_slug": "historico-escolar-e-academico",
"data": {
"ScholarshipHistory": [
{
"Level": "texto",
"Institution": "texto",
"SpecializationArea": "texto",
"StartYear": "texto",
"EndYear": "texto",
"EducationalLevel": "texto"
}
],
"PublicationHistory": [
],
"ScholarshipLevel": "texto",
"EducationalLevel": "texto",
"NumberOfUndergraduateCourses": 0,
"IsUniversityStudent": false,
"IsCurrentlyOnAcademicField": false,
"CreationDate": "2026-01-01",
"LastUpdateDate": "2026-01-01"
},
"consulted_at": "2026-01-01T12:00:00Z",
"query_cost": "0.100"
}
Cobrança e respostas
- O valor é cobrado por consulta bem-sucedida.
- 200 — consulta processada (veja status no corpo da resposta)
- 401 — token ausente, inválido, inativo ou expirado
- 403 — serviço fora do escopo da chave, IP não autorizado ou limite de consumo excedido
- 422 — campo obrigatório ausente/inválido ou payload acima do limite do serviço
- 429 — limite de requisições por minuto da chave excedido
- 504 — tempo máximo de execução do serviço excedido