Trackers (global)
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 list of tracker codes configured in the system. For a list of tracker codes assigned to a specific applicant, see Trackers.
URI
/api/v9/applicants/trackersGET List trackers
Get a list of all tracker codes currently available in the system.
Syntax
GET /api/v9/applicants/trackers
Host: apply.example.edu
Authorization: DREAM apikey="..."Example request
Request
curl
curl \
-X GET \
-H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
"https://apply.example.edu/api/v9/applicants/trackers"Response headers
| Header | Value | Description |
|---|---|---|
Content-Type | application/json | Media type of the resource |
Content-Length | 1456 | Size of the response body in bytes |
X-Count | 2 | Number of returned trackers |
Response codes
| Response code | Description |
|---|---|
200 OK | The list of tracker codes was successfully returned |
Example response
Response
{
"1": {
"id": 1,
"created": "2025-07-29T12:53:20+00:00",
"code": "DISCOUNT10",
"notes": "Tracker code to provide a discount to early applicants",
"reduction": {
"reduction": "Percent",
"percent": 10
}
},
"2": {
"id": 2,
"created": "2025-08-27T09:18:38+00:00",
"code": "FACEBOOK",
"notes": null,
"reduction": null
}
}POST Create a tracker
Add a new tracker using any text (2 to 16 characters) as the tracker code. The URI for the tracker created is returned in the Location header.
If a tracker with this code exists, a 409 Conflict will be returned, along with the URI of the offending tracker in the Location header.
This request creates a new tracker, but does not assign it to any applicants. You can later set the tracker to any number of applicants using PUT /api/v9/applicants/ID/trackers/ID.
Syntax
POST /api/v9/applicants/trackers
Host: apply.example.edu
Authorization: DREAM apikey="..."Parameters
| Name | Required\Optional | Description |
|---|---|---|
code | Required | This is the unique tracker code, should be easily recognisable. 2 to 16 characters. |
notes | Required | This text will be used to additionally explain the meaning of the tracker code. 2 to 200 characters. |
Example request
Request
curl
curl \
-X POST \
-H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
"https://apply.example.edu/api/v9/applicants/trackers?code=2025¬es=fall%20campaign%20tracker"Response headers
| Header | Value | Description |
|---|---|---|
Content-Type | application/json | Media type of the resource |
Content-Length | 0 | Size of the response body in bytes |
Location | /api/applicants/trackers/NAME | URI of the created tracker |
Response codes
| Response code | Description |
|---|---|
201 Created | A new tracker was created |
409 Conflict | A tracker with this code already exists |