Higher education

View as Markdown
University degrees held by your customer, from the official education registry. One entry per degree, with the awarding institution and the dates. Background screening against the register rather than against a CV. Field by field in [Academic Records](/guides/data-models/academic). <Note title="Requires the `academic_data` feature"> Features are chosen when the execution **starts**, not here. An execution that did not ask for `academic_data` answers `204`, and the only way to get the data is to run another one. The same feature produces [Secondary education](api:GET/executions/results/{execution_id}/public/v1/academic/secondary-education), so asking for it once fills both endpoints. </Note> | Status | Meaning | | :--- | :--- | | `200` | The degrees. | | `202` | `feature_not_ready` — `academic_data` is still running. **Only this family waits**: the ones that already closed answer now. | | `204` | The execution never asked for `academic_data`. No body. | | `404` | No execution with that id for your application, or it has been deleted. | <Note> **Server to server only.** This call is authorised with your application secret: it belongs in your backend, never in a browser, a mobile app or anything your customer can read. </Note>

Authentication

X-APP-SECRETstring
Application Secret

Path parameters

execution_idstringRequiredformat: "object-id"
The execution, as the acceptance response returned it.

Response

200 OK
University degrees as the ministry records them: the title, the institution that issued it and the date it was obtained — the source is the register, not a CV.

An empty list is an answer, not a gap: the feature ran and the source reported none.

product"academic_data"
sub_familyenum
fetch_datestringformat: "datetime"
Date this product was fetched
qualification_namestring
Qualification name.
institution_namestring
Institution name.
institution_countrystringformat: "country"
Country of the institution.
completion_statusstring
Completion status
total_creditsstringformat: "number"

ECTS credits (Common in Europe)

grade_averagestringformat: "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”)

Errors

404
Not Found Error
422
Unprocessable Entity Error