Data models

Academic Records

The person's official education records
View as Markdown

Where it lives: in the Spain Public Administration results, at data.academic.higher_education_degrees and data.academic.secondary_education. APIs with dedicated per-product results endpoints return this model directly.

Official academic records, straight from the public registries — use them for background screening and credential verification without chasing paper certificates.

Higher education

One entry per university degree:

product"academic_data"Required
sub_familyenumRequired
Allowed values:
fetch_datestringRequiredformat: "datetime"
Date this product was fetched
qualification_namestringRequired
Qualification name.
institution_namestringRequired
Institution name.
institution_countrystringRequiredformat: "country"
Country of the institution.
completion_statusstringRequired
Completion status
total_creditsstringRequiredformat: "number"

ECTS credits (Common in Europe)

grade_averagestringRequiredformat: "number"

GPA or local scale (e.g., 0-10 in Spain)

issue_datedateOptional
Date when the qualification was issued.
start_datedateOptional
Date when the education started.
end_datedateOptional
Date when the education ended.
official_idstringOptional

National registry number / Diploma serial number.

verification_urlstringOptional
Link to public administration validator.
thesis_titlestringOptional

Thesis title - Mandatory for PhD, common for Master

field_of_studystringOptional

ISCED-F code or name (e.g., "061 ICTs")

Secondary education

product"academic_data"Required
sub_familyenumRequired
Allowed values:
fetch_datestringRequiredformat: "datetime"
Date this product was fetched
qualification_namestringRequired
Qualification name.
institution_namestringRequired
Institution name.
institution_countrystringRequiredformat: "country"
Country of the institution.
completion_statusstringRequired
Completion status
institution_codestringOptional
Local school ID or center code.
regionstringOptional
State, Province, or Autonomous Community.
issue_datedateOptional
Date when the qualification was issued.
start_datedateOptional
Date when the education started.
end_datedateOptional
Date when the education ended.
official_idstringOptional

National registry number / Diploma serial number.

verification_urlstringOptional
Link to public administration validator.
study_frameworkstringOptional

Education system/law (e.g., "LOE", "K-12", "GCSE")

national_registry_idstringOptional

National level ID (e.g., MEC in Spain)

regional_registry_idstringOptional

State/Regional level ID

archive_volumestringOptional

Book/Volume number (Libro)

archive_entrystringOptional

Entry or order number (Folio/Orden)