POST /api/snies/programs
Price: 20 credits
Get one Colombian higher-education programme from SNIES by its SNIES code: its degree title, status, ministry recognition and its legal basis, approval resolution and dates, high-quality accreditation resolution, dates and validity, CINE-F 2013 fields, levels, modality, credits, duration, tuition for new students, the institution that offers it, every location where it is offered, and the offer table with each offer's validity dates and first-year student count.
Use this to read one programme behind an `id` from snies/programs/search; it adds `offers`, the per-location offer table with validity dates. Labels are in Spanish as SNIES publishes them.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)program string required — SNIES code of the programme (examples: "116773", "19"; minLength: 1; maxLength: 8)@type string (default: "SniesProgramDetail")id string requiredname string nullabledegree_title string nullablestatus string nullableunique_registry string nullableicfes_code string nullablejustification string nullablejustification_detail string nullableministry_recognition string nullableapproval_resolution string nullableresolution_date integer nullableresolution_effective_date integer nullablevalidity_years number nullableregistered_at integer nullablecine_broad_field string nullablecine_specific_field string nullablecine_detailed_field string nullableknowledge_area string nullablebasic_knowledge_core string nullableacademic_level string nullableformation_level string nullablemodality string nullablecredit_count integer nullableduration_period_count integer nullableperiodicity string nullablehas_propaedeutic_cycles boolean nullableadmission_periodicity string nullableis_in_agreement boolean nullableoffer_department string nullableoffer_municipality string nullablenew_student_tuition_cop number nullabletransitional_validity_date integer nullabletransitional_validity_note string nullableinstitution object nullable@type string (default: "SniesProgramInstitution")id string nullableparent_id string nullablename string nullablestatus string nullableacademic_character string nullablesector string nullablelocations array (default: [])@type string (default: "SniesProgramLocation")coverage_type string nullabledepartment string nullablemunicipality string nullableinstitution_id string nullableinstitution_name string nullabletuition_cop number nullableagreement_locations array (default: [])@type string (default: "SniesProgramLocation")coverage_type string nullabledepartment string nullablemunicipality string nullableinstitution_id string nullableinstitution_name string nullabletuition_cop number nullableministry_recognition_basis string nullableregistry_recognition string nullablehigh_quality_recognition string nullablehigh_quality_resolution string nullablehigh_quality_resolution_date integer nullablehigh_quality_effective_date integer nullablehigh_quality_validity_years number nullableoffers array (default: [])@type string (default: "SniesProgramOffer")program_id string nullablemodality string nullablecoverage_type string nullabledepartment string nullablemunicipality string nullabletuition_cop number nullablefirst_year_student_count integer nullableunique_registry string nullablestatus string nullablevalid_from_date integer nullablevalid_until_date integer nullabledegree_type string nullableagreement_institutions string nullablecode_history array (default: [])@type string (default: "SniesProgramCodeChange")program_id string nullablestatus string nullableunique_registry string nullablename string nullableformation_level string nullablevalid_from_date integer nullablevalid_until_year integer nullablecreated_year 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 programme with that SNIES code exists in SNIES. 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.