POST /api/enickz/institutions
Price: 10 credits
Get the public passport of a Kazakh higher-education institution on EPVO: licence with its appendices, founders, leader position, foreign representations, address, accreditation body and term, study languages and durations, programmes, and staff and student counts
Pass an `id` from enickz/institutions/search. Names come in English, Russian and Kazakh.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)id integer required — EPVO id of the institution. (examples: 80; min: 1)@type string (default: "EnickzInstitution")id integer requiredname object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullableis_foreign_representation boolean nullableforeign_representations array (default: [])@type string (default: "EnickzForeignRepresentation")id integer requiredname object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullablestatus_name object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullablerepresentation_type object nullable@type string (default: "EnickzRef")id integer requiredcode string nullablename object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullablecountry object nullable@type string (default: "EnickzCountry")id integer requiredcode string nullablealpha2_code string nullablealpha3_code string nullablename object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullableagreement_type object nullable@type string (default: "EnickzRef")id integer requiredcode string nullablename object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullableopened_at integer nullableclosed_at integer nullablephone string nullableemail string nullableregistered_at integer nullableregional_department_code string nullableregional_department_name object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullableaddress object nullable@type string (default: "EnickzAddress")text object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullablekato_code string nullablerka_code string nullablelicense object nullable@type string (default: "EnickzLicense")number string nullableissued_at integer nullableis_perpetual boolean nullablestatus object nullable@type string (default: "EnickzRef")id integer requiredcode string nullablename object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullablelicensor object nullable@type string (default: "EnickzLicensor")id integer requiredcode string nullablebin string nullablename object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullableappendices array (default: [])@type string (default: "EnickzLicenseAppendix")id integer requiredcode string nullablenumber string nullablename object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullableissued_at integer nullableparent_id integer nullableis_history boolean nullableis_deleted boolean nullableleader object nullable@type string (default: "EnickzLeader")position object nullable@type string (default: "EnickzRef")id integer requiredcode string nullablename object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullableappointed_at integer nullableleft_at integer nullableperson_founder_count integer nullablelegal_founder_count integer nullablelegal_founders array (default: [])@type string (default: "EnickzLegalFounder")bin string nullablename object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullableregistration_number string nullableaccreditation object nullable@type string (default: "EnickzAccreditation")body object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullablevalidity string nullablevalid_from integer nullablevalid_to integer nullablestudy_languages object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullablehas_professional_standard boolean nullablestudy_durations array (default: [])@type string (default: "EnickzStudyDuration")name object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullabledegree object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullablestudy_form object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullablecourse_count integer nullableterm_count integer nullablecompletion_term integer nullableis_distance_learning boolean nullableupdated_at integer nullableprograms array (default: [])@type string (default: "EnickzInstitutionProgram")name object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullabledegree object nullable@type string (default: "EnickzText")en string nullableru string nullablekz string nullableis_accredited boolean nullableis_for_disabled_students boolean nullablecost number nullableupdated_at integer nullablestaff object nullable@type string (default: "EnickzStaff")total_count integer nullableforeign_count integer nullablefull_time_count integer nullablepart_time_count integer nullablemasters_count integer nullablecandidates_of_science_count integer nullabledoctors_of_science_count integer nullabledoctors_phd_count integer nullabledoctors_specialized_count integer nullableprofessors_count integer nullableassociate_professors_count integer nullabledocents_count integer nullableassociate_professor_docents_count integer nullableprofessors_new_qualification_count integer nullableno_academic_status_count integer nullablestudents object nullable@type string (default: "EnickzStudents")total_count integer nullablebachelor_count integer nullablespecialist_count integer nullableinternship_count integer nullablemaster_count integer nullableresidency_count integer nullabledoctorate_count integer nullable422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.412 — No institution passport with this id Retrying will not help: either the entity does not exist, or the input points at a different one.429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.X-Error — Error message text (present only on error)X-Request-ID — Unique request identifierX-Execution-Time — Execution time in secondsX-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.X-Retry-After — Seconds to wait before retrying. Present only on 429.