POST /api/caauae/programmes
Price: 10 credits
Get one programme from the UAE register of accredited higher education programmes by id or URL: English and Arabic name and level, institution, status, concentrations, area of subject, accreditation decision and the date the accreditation is valid until.
Programmes under review or with admissions ceased carry no accreditation decision or validity date; their area of subject and study level are filled like every other programme's.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)programme string required — CAA programme id or programme page URL (examples: "391", "https://www.caa.ae/Pages/Programs/Details.aspx?GUID=391")@type string (default: "CaauaeProgrammeDetail")id string required — CAA programme id (examples: "391")url string required — Programme page on caa.aename string nullable — Programme name in Englishname_ar string nullable — Programme name in Arabiclevel string nullable — Programme level in English (examples: "BACHELOR")level_ar string nullable — Programme level in Arabic (examples: "بكالوريوس")level_code string nullable — Degree abbreviation (examples: "B", "BSC", "MSC")study_level string nullable — Study level category (examples: "BACHELOR")study_level_id string nullable — Study level category id (examples: "81")subject_area string nullable — Area of subject (examples: "Business/Management")subject_area_id string nullable — Area of subject id (examples: "243")status string nullable — Programme status (examples: "Active", "Inactive")status_code string nullable — Programme status code (examples: "A", "X", "O")programme_code string nullable — Programme code (examples: "PHAR")programme_number string nullable — Programme number (examples: "217")decree string nullable — Accreditation decision reference (examples: "08 December 2025 Decision by CAA Director")decree_date integer nullable — Accreditation decision date, unix secondsvalidity_date integer nullable — Accreditation valid until, unix secondscreated_at integer nullable — When the register entry was created, unix secondsupdated_at integer nullable — When the register entry was last updated, unix secondsinstitution_id string nullable — CAA institution id (examples: "39")institution_name string nullable — Institution name in Englishinstitution_name_ar string nullable — Institution name in Arabicinstitution_url string nullable — Institution page on caa.aeemirates array — Emirates the institution is listed in (default: []; examples: ["Dubai"])concentrations array — Concentrations (specialisations) of the programme (default: [])@type string (default: "CaauaeConcentration")name string nullable — Concentration name in English (examples: "FINANCE")name_ar string nullable — Concentration name in Arabic (examples: "التمويل")status string nullable — Concentration status (examples: "Active", "Inactive")422 — 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 is registered 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.