Applicant
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 an applicant or lead registered in DreamApply.
URI
/api/v9/applicants/IDGET Get an applicant
Return information about an applicant identified by the applicant ID.
Syntax
GET /api/v9/applicants/123
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/123"Response headers
| Header | Value | Description |
|---|---|---|
Content-Type | application/json | Media type of the resource |
Content-Length | 1234 | Size of the response body in bytes |
Response codes
| Response code | Description |
|---|---|
200 OK | The applicant information was successfully returned |
404 Not Found | The applicant was not found |
Example response
Response
{
"id": 123,
"type": "Natural",
"registered": "2025-11-24T10:56:34+00:00",
"name": {
"full": "John Smith",
"given": "John",
"middle": null,
"family": "Smith"
},
"email": "john.smith@email.com",
"phone": "",
"reference": null,
"matriculation": null,
"citizenship": "GB",
"notes": null,
"applications": "/api/v9/applicants/123/applications",
"trackers": "/api/v9/applicants/123/trackers",
"photo": "/api/v9/applicants/123/photo",
"consents": "/api/v9/applicants/123/consents",
"invoices": "/api/v9/applicants/123/invoices",
"wishes": "/api/v9/applicants/123/wishes",
"documents": "/api/v9/applicants/123/documents"
}