Extra score
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 the extra score set for the application offer.
URI
/api/v9/applications/ID/offers/ID/score/extraGET Get the extra score
A request with the GET verb returns the extra score for the application offer in question.
Syntax
GET /api/v9/applications/123/offers/321/score/extra
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/offers/321/score/extra"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 extra score was successfully returned |
404 Not Found | The application does not have this offer |
Example response
Response
"82.46"PUT Set the extra score
Set the extra score for the application offer (identified by its ID) in question. This will check if the given score is a valid value and will assign it to the application offer upon successful validation.
Syntax
PUT /api/v9/applications/123/offers/321/score/extra
Host: apply.example.edu
Authorization: DREAM apikey="..."Raw request body
This will be set as the extra score for the application offer in question, upon successful validation.
Request body
"25.50"Example request
Request
curl
curl \
-X PUT \
-H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
-d '"25.50"' \
"https://apply.example.edu/api/v9/applications/123/offers/321/score/extra"Response headers
| Header | Value | Description |
|---|---|---|
Content-Type | text/plain | Media type of the resource |
Content-Length | 0 | Size of the response body in bytes |
Response codes
| Response code | Description |
|---|---|
200 OK | The extra score was successfully set. |
400 Bad Request | Invalid input. |
400 Bad Request | Invalid score. The score must be a decimal value with 2 decimal points separated by a dot. |
404 Not Found | The application does not have this offer. |
DELETE Delete the extra score
Clear the extra score for the application offer (identified by its ID) in question.
Syntax
DELETE /api/v9/applications/123/offers/321/score/extra
Host: apply.example.edu
Authorization: DREAM apikey="..."Example request
Request
curl
curl \
-X DELETE \
-H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
"https://apply.example.edu/api/v9/applications/123/offers/321/score/extra"Response headers
| Header | Value | Description |
|---|---|---|
Content-Type | text/plain | Media type of the resource |
Content-Length | 0 | Size of the response body in bytes |
Response codes
| Response code | Description |
|---|---|
204 No Content | The score was successfully cleared |
400 Bad Request | Invalid input |