Dados cadastrais

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

CampoObrigatórioDescriçã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.

CampoTipo
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