References
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 references submitted by referees for the application.
URI
/api/v9/applications/ID/referencesGET List references
Get a list of references that referees have submitted for the application in question.
Syntax
GET /api/v9/applications/123/references
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/applications/123/references"Response headers
| Header | Value | Description |
|---|---|---|
Content-Type | application/json | Media type of the resource |
Content-Length | 1234 | Size of the response body in bytes |
X-Count | 2 | Number of references submitted for this application |
Response codes
| Response code | Description |
|---|---|
200 OK | The list of references was successfully returned |
Example response
Response
{
"1": {
"id": 1,
"invited": "2026-02-17T11:14:44+00:00",
"accessed": "2026-02-17T11:15:17+00:00",
"committed": "2026-02-17T11:17:54+00:00",
"invitation": {
"name": "John Smith",
"email": "john.smith@email.com"
},
"data": {
"referee": {
"name": "Linda Jason"
},
"evaluation": {
"essay": "Candidate Assessment:Linda Jason\n\nIt is a pleasure to recommend Linda Jason for admission to your program. Having observed their development over the past 3 years in my capacity as mentor, I have found them to be an individual who consistently exceeds expectations through a rare combination of analytical rigor and proactive leadership.\n\nAcademic and Professional Excellence \n\nAcademically, Linda Jason possesses an exceptional ability to synthesize complex information. Unlike many peers who are content with a surface-level understanding, they possess a \"first-principles\" approach to problem-solving. They do not merely follow instructions; they interrogate the underlying logic to ensure the most efficient and innovative outcome. Their technical proficiency is matched by a tireless work ethic, often taking on additional responsibilities to ensure the success of the broader team.\n\nPersonal Characteristics \n\nBeyond their professional capabilities, Linda Jason brings a unique interpersonal energy to any environment. They possess a high degree of emotional intelligence, which allows them to navigate high-pressure situations with a grounded, calm demeanor. In group settings, they are a natural \"bridge-builder\"—someone who listens as effectively as they lead. I have witnessed them mentor junior members with genuine empathy while simultaneously holding the group accountable to high standards. They approach challenges with a growth mindset, treating setbacks not as failures but as necessary data points for future success.\n\nConclusion \n\nWhat truly differentiates Linda Jason is their intellectual humility; despite their significant achievements, they remain deeply coachable and eager to learn. I am confident that they will not only succeed in your program but will also become a vital contributor to your community. I recommend them without reservation."
}
}
},
"2": {
"id": 2,
"invited": "2026-02-17T11:15:03+00:00",
"accessed": "2026-02-17T11:19:05+00:00",
"committed": "2026-02-17T11:19:18+00:00",
"invitation": {
"name": "Sarah Tyler",
"email": "sarah.tyler@email.com"
},
"data": {
"referee": {
"name": "Linda Jason"
},
"evaluation": {
"essay": "It is a pleasure to recommend Linda Jason, a candidate who stands out through her sharp analytical mindset and exceptional interpersonal maturity.\n\nAcademic and Professional Excellence\nLinda possesses a remarkable ability to transform complex data into actionable strategies. During her tenure, she spearheaded a cross-departmental project that improved efficiency by 20%, demonstrating a \"first-principles\" approach to problem-solving. She doesn't just execute tasks; she optimizes them, consistently delivering high-quality results under tight deadlines.\n\nPersonal Characteristics\nWhat truly differentiates Linda is her emotional intelligence and leadership style. She is a natural \"bridge-builder\" who maintains a calm, grounded demeanor even in high-pressure environments. Linda balances a high standard of accountability with genuine empathy, making her a vital asset to any collaborative team. Her intellectual humility and eagerness to grow ensure she will be a standout contributor to your program."
}
}
}
}