Ranking
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 ranking list created in DreamApply.
URI
/api/v10/rankings/IDGET Get a ranking
Retrieve information about a specific ranking list.
This request is supported in API version 10 and later.
Syntax
GET /api/v10/rankings/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/v10/rankings/123"Response headers
| Header | Value | Description |
|---|---|---|
Content-Type | application/json | The media type of the resource |
Content-Length | 1234 | The size of the response body in bytes |
Response codes
| Response code | Description |
|---|---|
200 OK | The information about the ranking list was successfully returned |
404 Not Found | The ranking list was not found |
Example response
Response
{
"id": 1,
"created": "2026-05-20T11:01:02+00:00",
"modified": "2026-05-20T11:01:02+00:00",
"title": "Computer Science and Engineering Ranking",
"offers": "/api/v10/rankings/1/offers"
}