> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://infonite.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://infonite.dev/_mcp/server. # Secondary education GET https://clients.infonite.tech/api/executions/results/{execution_id}/public/v1/academic/secondary-education Secondary and vocational studies held by your customer, from the official education registry. The same register as the university degrees, one level below: what was studied, where, and when it was completed. Field by field in [Academic Records](/guides/data-models/academic). 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 [Higher education](api:GET/executions/results/\{execution_id}/public/v1/academic/higher-education-degrees). | Status | Meaning | | :----- | :--------------------------------------------------------------------------------------------------------------------------- | | `200` | The records. | | `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. | **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. Reference: https://infonite.dev/api-reference/direct-executions/direct-executions-api/fetching-the-results/public-administration/direct-executions-v-1-results-public-secondary-education ## Authentication - `X-APP-SECRET` header (required) — Application Secret ## Servers - `https://clients.infonite.tech/api` (Legacy Server, default) - `https://clients.infonite.io/api` (Production Server) ## Request ### Path parameters - `execution_id` (string, required) — The execution, as the acceptance response returned it. ## Response ### 200 **200 OK**Secondary studies on the same register as the degrees. **Both read from the same `academic_data` feature**, so an execution that asked for it can call either. **An empty list is an answer, not a gap**: the feature ran and the source reported none. - `list of object` - `product` ("academic_data", required) - `sub_family` (enum, required) - Allowed values: `academic_data:secondary_general`, `academic_data:secondary_vocational`, `academic_data:professional_certification` - `fetch_date` (string, required) — Date this product was fetched - `qualification_name` (string, required) — Qualification name. - `institution_name` (string, required) — Institution name. - `institution_country` (string, required) — Country of the institution. - `completion_status` (string, required) — Completion status - `institution_code` (string, optional) — Local school ID or center code. - `region` (string, optional) — State, Province, or Autonomous Community. - `issue_date` (date, optional) — Date when the qualification was issued. - `start_date` (date, optional) — Date when the education started. - `end_date` (date, optional) — Date when the education ended. - `official_id` (string, optional) — National registry number / Diploma serial number. - `verification_url` (string, optional) — Link to public administration validator. - `study_framework` (string, optional) — Education system/law (e.g., "LOE", "K-12", "GCSE") - `national_registry_id` (string, optional) — National level ID (e.g., MEC in Spain) - `regional_registry_id` (string, optional) — State/Regional level ID - `archive_volume` (string, optional) — Book/Volume number (Libro) - `archive_entry` (string, optional) — Entry or order number (Folio/Orden) ### 202 **202 Accepted**`feature_not_ready`: `academic_data` is still running. **You do not have to wait for the whole execution** — every family answers as soon as its own feature closes, so a slow source does not hold up the ones that already finished. - `detail` (string, required) — Error message ## Errors ### 404 Not Found Error **404 Not Found**No execution with that id for your application, or it has been deleted. - `detail` (string, required) — Error message ### 422 Unprocessable Entity Error Validation Error - `detail` (list of object, optional) - `loc` (list of string or integer, required) - `msg` (string, required) - `type` (string, required) - `input` (any, optional) - `ctx` (object, optional) ## Examples ### Two secondary records **Response** ```json [ { "product": "academic_data", "sub_family": "academic_data:secondary_general", "fetch_date": "2026-09-12T00:46:01+00:00", "qualification_name": "Graduado en Educación Secundaria Obligatoria", "institution_name": "ESTUDIO", "institution_country": "ES", "completion_status": "completed", "institution_code": "00000000", "region": "MADRID", "issue_date": "2000-07-21", "end_date": "2000-05-31", "official_id": "", "study_framework": "LOE", "national_registry_id": "200000000000", "regional_registry_id": "132000000000", "archive_volume": "00000", "archive_entry": "00000" }, { "product": "academic_data", "sub_family": "academic_data:secondary_general", "fetch_date": "2026-09-12T00:46:01+00:00", "qualification_name": "Bachiller en la modalidad de Humanidades y Ciencias Sociales", "institution_name": "ISAAC NEWTON", "institution_country": "ES", "completion_status": "completed", "institution_code": "00000000", "region": "MADRID", "issue_date": "2002-05-24", "end_date": "2002-04-30", "official_id": "", "study_framework": "LOE", "national_registry_id": "200200000000", "regional_registry_id": "000000000000", "archive_volume": "00000", "archive_entry": "00000" } ] ``` **SDK Code** ```python Two secondary records import requests url = "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education" headers = {"X-APP-SECRET": ""} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript Two secondary records const url = 'https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education'; const options = {method: 'GET', headers: {'X-APP-SECRET': ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Two secondary records package main import ( "fmt" "net/http" "io" ) func main() { url := "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("X-APP-SECRET", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Two secondary records require 'uri' require 'net/http' url = URI("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["X-APP-SECRET"] = '' response = http.request(request) puts response.read_body ``` ```java Two secondary records import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education") .header("X-APP-SECRET", "") .asString(); ``` ```php Two secondary records request('GET', 'https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education', [ 'headers' => [ 'X-APP-SECRET' => '', ], ]); echo $response->getBody(); ``` ```csharp Two secondary records using RestSharp; var client = new RestClient("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education"); var request = new RestRequest(Method.GET); request.AddHeader("X-APP-SECRET", ""); IRestResponse response = client.Execute(request); ``` ```swift Two secondary records import Foundation let headers = ["X-APP-SECRET": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### This family has not finished **Response** ```json { "detail": "feature_not_ready" } ``` **SDK Code** ```python This family has not finished import requests url = "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education" headers = {"X-APP-SECRET": ""} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript This family has not finished const url = 'https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education'; const options = {method: 'GET', headers: {'X-APP-SECRET': ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go This family has not finished package main import ( "fmt" "net/http" "io" ) func main() { url := "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("X-APP-SECRET", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby This family has not finished require 'uri' require 'net/http' url = URI("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["X-APP-SECRET"] = '' response = http.request(request) puts response.read_body ``` ```java This family has not finished import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education") .header("X-APP-SECRET", "") .asString(); ``` ```php This family has not finished request('GET', 'https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education', [ 'headers' => [ 'X-APP-SECRET' => '', ], ]); echo $response->getBody(); ``` ```csharp This family has not finished using RestSharp; var client = new RestClient("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education"); var request = new RestRequest(Method.GET); request.AddHeader("X-APP-SECRET", ""); IRestResponse response = client.Execute(request); ``` ```swift This family has not finished import Foundation let headers = ["X-APP-SECRET": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/public/v1/academic/secondary-education")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```