This is an old revision of the document!


/api/applications

HEAD, GET

Retrieve a list of applications that match the set filtering criterion. As per norm, the HEAD verb is useful to just test if such an application exist (and how many).

Syntax

GET /api/applications
Host: apply.example.edu
Authorization: DREAM apikey="..."

Parameters

Name Description Notes
byCommenceYear Required Year number, for example “2015”. Default: current calendar year number
byStatuses Optional List of application statuses. [1]
byCourseIDs Optional List of course IDs. An application will match if it contains at least one of the listed courses. [1]
byCourseTypes Optional List of course types. An application will match if it contains at least one course of the listed types. [1]
byCourseInstitutionIDs Optional List of institution IDs. An application will match if it contains at least one course from the listed institutions. [1]
byCourseIntakeIDs Optional List of intake IDs. An application will match if it contains at least one course under the listed intakes. [1]
byOfferTypes Optional List of offer types. An application will match if it contains at least one offer of the listed types. [1] [2]
byOfferConfirmed Optional Set to true to limit to offers that have been confirmed. [1] [2]
byOfferDecisions Optional List of offer decisions. [1] [2]
byFlagIDs Optional List of flag IDs [1]
  • Note [1]: Lists can be either comma or space separated. All list items are combined with logical OR operators - in other words an application is considered matching if it matches to any of the values in the list.
  • Note [2]: This limits selection to applications that have been submitted, since offers (initially in “Unreplied” status) will be created while submitting an application. An application may contain any number of courses, but they will be turned into offers only at submission. This also applies to edits made after submission. For example an applicant may add a course after submission, but the corresponding offer will appear only after submission.

Response headers

Content-Type: application/json
Content-Length: 1456
X-Count: 15