This is an old revision of the document!


/api/applicants

HEAD, GET

List applicants using the filters set as parameters. The number of applicants is represented in the X-Count header - use the HEAD request to simply count the number of applicants matching the filters. Use the GET request to actually fetch them.

Syntax

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

Parameters

Name Description Notes
byCitizenships Optional List of ISO 3166-1 alpha-2 country codes [1]
byTrackerIDs Optional List of tracker ID-s [1] [2] 
byTrackerCodes Optional List of tracker codes [1] [2]
  • 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]: you may use either tracker ID-s or codes to reference trackers. However ID-s are guaranteed not to change while the tracker codes offer no such guarantee.

Response headers

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