POST /api/studyincz/programmes
Price: 5 credits
Get one Czech university study programme from Study in Czechia by its page URL: programme code and type, ISCED field, languages, forms, duration, degree, credits, last year's applicant and admitted counts, application dates and fee, descriptions, the university's profile and the programme, university and faculty contacts.
Read a Czech study programme from a url returned by studyincz/programmes/search. A few programme URLs are shared by programmes of different faculties; the page describes one of them.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)programme string required — Study in Czechia programme page URL, or its university and programme aliases (examples: "https://studyin.gov.cz/plan-your-studies/universities/charles-university/modern-history", "vsb-technical-university-of-ostrava/nanotechnology-1")@type string (default: "StudyinczProgramme")id string nullablename string nullableurl string nullablealias string nullableuniversity_alias string nullableuniversity_name string nullablefaculty_name string nullableprogramme_code string nullableprogramme_type string nullablefield_of_study string nullableisced_code string nullablestudy_languages array (default: [])study_forms array (default: [])duration_years number nullablelocation string nullableawarded_degree string nullablecredits integer nullableapplicant_count integer nullableadmitted_count integer nullabledescription string nullableadmission_procedure_forms array (default: [])application_start_at integer nullableapplication_deadline_at integer nullableapplication_fee_amount number nullableapplication_fee_currency string nullabletuition_fee_amount number nullabletuition_fee_currency string nullabletuition_fee_note string nullableadmission_description string nullablegraduate_profile string nullablewebsite string nullableapplication_url string nullableopen_days_url string nullablepreparatory_courses_url string nullableemail string nullablephone string nullableuniversity_type string nullableuniversity_founded_year integer nullableuniversity_abbreviation string nullableuniversity_student_count integer nullableuniversity_international_student_count integer nullableuniversity_exchange_student_count integer nullableuniversity_international_alumni_count integer nullableuniversity_description string nullablecontacts array (default: [])@type string (default: "StudyinczContact")role string nullablename string nullableaddress string nullablenote string nullableemail string nullablephone string nullablelinks array (default: [])@type string (default: "StudyinczLink")label string nullableurl string nullableother_attributes array (default: [])@type string (default: "StudyinczAttribute")label string nullablevalue string 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 study programme is listed at that Study in Czechia address. 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.