Skip to navigation
Data models

Academic Records

The person's official degrees and qualifications, from the Spanish registries
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.

The official degrees the person holds, as the Ministry’s registries record them, read through the Carpeta Ciudadana in their name and with their consent. Use them to check a CV, a regulated profession or a scholarship requirement without chasing paper certificates — or a photocopy someone edited.

What is in it, and what is not

  • University degrees — every official university degree whose title has been issued: the qualification, the university, when it was finished and issued, and its official title number (official_id). Read the level from qualification_name (Grado, Máster, Doctor…): sub_family does not tell them apart yet.
  • Non-university qualifications — Bachillerato, vocational training (Formación Profesional) and the rest of the official titles below university: the school and its code, the province, the education law it was obtained under (study_framework) and its national and regional registry numbers.
  • Not in it: degrees a university awards on its own (títulos propios), courses, and grades or credits. The registries record that a title was awarded, not the transcript.

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 and vocational education

One entry per non-university qualification:

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)