Course
API version
Select a version to change the base URI
in syntax and code examples. Learn about versions:
in syntax and code examples. Learn about versions
Represents a course associations for an application.
/api/v10/applications/ID/courses/IDGET Get a course
Retrieve information about a specific course association (priority, date submitted and so on) for an application. An application can contain multiple courses (priorities) that the applicant has chosen to apply to.
This API request does not return the course itself. It represents a relationship between an application and a course added to it. Follow the course URI in the response to retrieve further information about the course.
Courses is the technical term for the resources to which applicants apply. In some educational systems, these resources can be referred to as programmes or courses. Additionally, in exchange setups, courses represent the mobilities available for application. In all variations — courses, programmes, mobilities — the technical term still remains “course”.
GET /api/v10/applications/123/courses/1
Host: apply.example.edu
Authorization: DREAM apikey="..."Example request
curl \
-X GET \
-H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
"https://apply.example.edu/api/v10/applications/123/courses/1"Response headers
| Header | Value | Description |
|---|---|---|
Content-Type | application/json | The media type of the resource |
Content-Length | 1234 | The size of the response body in bytes |
| Response code | Description |
|---|---|
200 OK | The course is being applied to with this application |
404 Not Found | The application does not have this course |
Example response
{
"priority": 1,
"submitted": "2025-10-02T12:31:47+00:00",
"deadline": "2025-06-01T23:59:59+00:00",
"course": "/api/v10/courses/1",
"intake": "/api/v10/intakes/2",
"modifier": "On-campus housing"
}DELETE Delete a course
Delete a course (priority) from an application.
When a course is deleted, DreamApply automatically reorders existing priorities to maintain a valid sequence.
This API request does not delete the course itself. It only removes the course association with the application.
DELETE /api/v10/applications/123/courses/1
Host: apply.example.edu
Authorization: DREAM apikey="..."Example request
curl \
-X DELETE \
-H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
"https://apply.example.edu/api/v10/applications/123/courses/1"Response headers
| Header | Value | Description |
|---|---|---|
Content-Type | text/plain | The media type of the resource |
Content-Length | 0 | The size of the response body in bytes |
Response codes
| Response code | Description |
|---|---|
204 No Content | The course was successfully deleted |
404 Not Found | The application does not have this course |