POST /api/universityadmissions/programmes/search
Price: 5 credits
Search the courses and programmes Swedish universities offer through University Admissions in Sweden, by term, words, institution, subject, degree, level, pace, teaching language and time, credits, distance study and application status. Returns each offering's codes, institution, credits, level, pace, place, language, tuition fee, entry requirements, application dates and course page
One record per offering per admission term: the same course in two terms is two records. Pass a record's `term_id` and `code` to universityadmissions/programmes to fetch it again.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)language string — sv returns every listed course and programme with Swedish labels; en returns those published for international applicants, with English labels (default: "sv"; one of: "sv", "en"; examples: "en")term string nullable — Admission term id; omitted, every open term in turn (examples: "28")query string nullable — Words to search for (examples: "computer science", "sjuksköterska")kind string nullable — Programmes or single courses (one of: "programme", "course"; examples: "course")level string nullable — Study level (one of: "basic", "advanced", "preparatory"; examples: "advanced")institutions array nullable — Institution codes from universityadmissions/institutions (examples: ["kth","cth"])subjects array nullable — Subject codes from universityadmissions/subjects, any level (examples: ["150-30-"])degree string nullable — Degree code from universityadmissions/degrees (examples: "171")pace string nullable — Study pace: full time, or at most 75, 50 or 25 percent (one of: "full_time", "up_to_75", "up_to_50", "up_to_25"; examples: "full_time")teaching_language string nullable — Teaching language: English, Swedish or another language (one of: "en", "sv", "other"; examples: "en")teaching_times array nullable — Times of day the teaching takes place (one of: "day", "evening", "weekend"; examples: ["evening","weekend"])term_period integer nullable — 1 starts in the first half of the term, 2 in the second (one of: 1, 2; examples: 1)min_credits number nullable — Lowest credits (examples: 60; min: 0)max_credits number nullable — Highest credits (examples: 15; min: 0)is_distance boolean nullable — True keeps only distance studies (examples: true)is_without_campus_meetings boolean nullable — True keeps only distance studies without campus meetings (examples: true)is_open_for_application boolean nullable — True keeps only those open for application now (examples: true)has_no_entry_requirements boolean nullable — True keeps only those without entry requirements (examples: true)sort string nullable — Order; omitted, relevance with a query and name otherwise (one of: "relevance", "name_asc", "name_desc", "institution_asc", "institution_desc", "credits_asc", "credits_desc"; examples: "name_asc")count integer required — Max number of results (examples: 100; min: 1; max: 15000)@type string (default: "UniversityadmissionsProgramme")id string required — Education event id of this offering in this termcode string nullable — Institution and application option code, the input of universityadmissions/programmesapplication_code string nullable — Application code shown to applicantsterm_id string required — Admission term idtitle string requiredis_programme boolean nullable — True for a programme, false for a single courseinstitution_code string nullable — Institution code, lower caseinstitution_name string nullablestatus string nullable — Application status codeapplication_opens_at integer nullableapplication_closes_at integer nullablelate_application_opens_at integer nullableadmission_round_code string nullableoption_code string nullable — Application option code within the institutioncredits number nullablecredit_unit string nullable — hp (higher-education credits) or fuplevel string nullable — Level code: grund, adv, grundadv or forutbpace_percent number nullableteaching_time string nullable — Teaching time code, such as DAG or KVAteaching_form string nullable — NML (campus) or DST (distance)location string nullableteaching_language string nullabledistance_description string nullablemeeting_count integer nullableoptional_campus_meeting_count integer nullablemandatory_distance_meeting_count integer nullableoptional_distance_meeting_count integer nullableyear integer nullableyear_period integer nullableterm_period integer nullable — 1 starts in the first half of the term, 2 in the secondstart_week integer nullable — ISO year and week the teaching starts, YYYYWWend_week integer nullable — ISO year and week the teaching ends, YYYYWWtuition_fee number nullable — Total tuition fee in SEK for applicants who pay feestuition_fee_first_instalment number nullable — First instalment in SEKentry_requirements object nullable@type string (default: "UniversityadmissionsRequirements")description string nullable — Entry requirements as written by the universityupper_secondary_gy11 string nullable — Required upper-secondary courses under the GY11 curriculumupper_secondary_gy25 string nullable — Required upper-secondary courses under the GY25 curriculumtype_code string nullable — Source code of the requirement typedegrees array (default: [])subjects array (default: [])course_url string nullableapplication_url 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 — The entity was not found, or a precondition failed 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.