POST /api/opintopolku/admissions
Price: 5 credits
Get one application option (hakukohde) from Opintopolku (Studyinfo), Finland's national study catalogue: application round and periods, places, prior education required, the selection criteria with every selection method, entrance exams, attachments to deliver, past admission scores and the implementation it admits to
Application option ids come from `admissions[].id` of opintopolku/implementations. Texts are HTML, given in every language the institution wrote them in.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)admission string required — Opintopolku application option id or its opintopolku.fi page URL (examples: "1.2.246.562.20.00000000000000087395", "https://opintopolku.fi/konfo/fi/hakukohde/1.2.246.562.20.00000000000000097384/valintaperuste"; minLength: 1)@type string (default: "OpintopolkuAdmission")id string requiredurl string nullablename object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablestatus string nullableapplication_round_id string nullableapplication_round_name object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableapplication_method_code string nullableimplementation_id string nullableimplementation object nullable@type string (default: "OpintopolkuProgramImplementation")id string requiredurl string nullablename object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablestatus string nullableorganisation object nullable@type string (default: "OpintopolkuOrganisation")id string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablemunicipality object nullable@type string (default: "OpintopolkuCode")code string requiredname object nullableorganisation_ids array (default: [])providers array (default: [])@type string (default: "OpintopolkuOrganisation")id string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablemunicipality object nullable@type string (default: "OpintopolkuCode")code string requiredname object nullable (see schema OpintopolkuText)modified_at integer nullableprogram_type string nullableprogram_type_path string nullableprogram_type_code string nullablelevel_codes array (default: [])teaching_language_codes array (default: [])is_degree_programme boolean nullablehigher_education_level object nullable@type string (default: "OpintopolkuHigherEducationLevel")level integer nullablecycle integer nullableis_lower boolean nullableis_upper boolean nullableadmission_code object nullable@type string (default: "OpintopolkuCode")code string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableapplication_periods array (default: [])@type string (default: "OpintopolkuApplicationPeriod")starts_at integer nullableends_at integer nullableis_open boolean nullableis_past boolean nullableuses_round_schedule boolean nullableuses_round_form boolean nullableapplication_form_url object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableplaces integer nullablefirst_timer_places integer nullableplaces_info object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablestart object nullable@type string (default: "OpintopolkuStartTerm")start_type string nullableterm object nullable@type string (default: "OpintopolkuCode")code string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableyear integer nullablestarts_at integer nullableends_at integer nullableindividual_plan_info object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableuses_round_start boolean nullableinferred_start object nullable@type string (default: "OpintopolkuInferredStart")start_type string nullableterm_code string nullableyear integer nullablestarts_at integer nullableis_individual boolean nullablesource_id string nullableprior_education array (default: [])@type string (default: "OpintopolkuCode")code string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableprior_education_info object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablethreshold_requirement object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableentrance_exams_overview object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableentrance_exams array (default: [])@type string (default: "OpintopolkuEntranceExam")id string nullableexam_type object nullable@type string (default: "OpintopolkuCode")code string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablename object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableinfo object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablerequires_preparation boolean nullablehas_special_arrangements boolean nullablespecial_arrangements_info object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableselection_criteria object nullable@type string (default: "OpintopolkuSelectionCriteria")id string nullablename object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullabledescription object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableeligibility object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableadditional_info object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableentrance_exams_overview object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablecontent array (default: [])@type string (default: "OpintopolkuContentBlock")block_type string nullabletext object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullabletable array (default: [])selection_methods array (default: [])@type string (default: "OpintopolkuSelectionMethod")method object nullable@type string (default: "OpintopolkuCode")code string requiredname object nullable (see schema OpintopolkuText)name object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablethreshold object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablemin_score number nullablemax_score number nullableuses_conversion_table boolean nullablecontent array (default: [])application_method object nullable@type string (default: "OpintopolkuCode")code string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullabletarget_group object nullable@type string (default: "OpintopolkuCode")code string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableprogram_type string nullablestatus string nullableis_public boolean nullableorganisation object nullable@type string (default: "OpintopolkuOrganisation")id string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablemunicipality object nullable@type string (default: "OpintopolkuCode")code string requiredname object nullablelanguages array (default: [])modified_at integer nullableattachments array (default: [])@type string (default: "OpintopolkuAttachment")id string nullableattachment_type object nullable@type string (default: "OpintopolkuCode")code string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablename object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullabledescription object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullabledeliver_by integer nullabledelivery_method string nullabledelivery_address object nullable@type string (default: "OpintopolkuAddress")street object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablepostal_code string nullablecity object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullabledelivery_url string nullableattachments_deliver_by integer nullableattachments_delivery_method string nullableattachments_share_deadline boolean nullableattachments_share_address boolean nullablescore_history array (default: [])@type string (default: "OpintopolkuScoreHistory")year integer nullablelowest_accepted_score number nullableplaces integer nullablefirst_choice_applicant_count integer nullableselection_method object nullable@type string (default: "OpintopolkuCode")code string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableselection_queue_id string nullableapplication_round_id string nullableadmission_id string nullableadmission_code object nullable@type string (default: "OpintopolkuCode")code string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableprovider_id string nullablenew_student_url object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableis_one_place_rule boolean nullableone_place_rule_reason string nullableis_double_degree boolean nullableasks_discretionary_admission boolean nullablemay_have_discretionary_applicants boolean nullablehas_athlete_vocational_training boolean nullablevenue object nullable@type string (default: "OpintopolkuOrganisation")id string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablemunicipality object nullable@type string (default: "OpintopolkuCode")code string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablevenue_full_name object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableorganisation object nullable@type string (default: "OpintopolkuOrganisation")id string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullablemunicipality object nullable@type string (default: "OpintopolkuCode")code string requiredname object nullable@type string (default: "OpintopolkuText")fi string nullablesv string nullableen string nullableexternal_id string nullablelanguages array (default: [])modified_at integer nullableindexed_at 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 application option is published under 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.