Date
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 date of a scoresheet score.
URI
/api/v10/scoresheets/ID/score/ID/dateGET Get the date
Retrieve the score date.
This API request returns the score date as a JSON encoded string or null, if no date is stored.
Syntax
GET /api/v10/scoresheets/123/score/321/date
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/scoresheets/123/scores/321/date"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 date was successfully returned |
404 Not Found | The scoresheet does not have this score |
Example response
Response
"2025-01-30"PUT Set the date
Set the date of a scoresheet score to the provided value.
Syntax
PUT /api/v10/scoresheets/123/scores/321/date
Host: apply.example.edu
Authorization: DREAM apikey="..."Raw request body
The request body must contain a valid JSON string — a date formatted as YYYY-MM-DD and enclosed in double quotes. The date cannot be in the future.
You cannot set a date to an empty value. Use the DELETE method for that.
Request body
"2025-12-24"Example request
Request
curl
curl \
-X PUT \
-H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
-d '"2025-12-24"' \
"https://apply.example.edu/api/v10/scoresheets/123/scores/321/date"Response headers
| Header | Value | Description |
|---|---|---|
Content-Type | text/plain | The media type of the resource |
Content-Length | 0 | The size of the response body in bytes |
Response codes
| Response code | Description |
|---|---|
204 No Content | The date was successfully saved |
404 Not Found | The scoresheet does not have this score |
400 Bad Request | The date text was not valid, ensure it is YYYY-MM-DD |
DELETE Delete the date
Delete the date of a scoresheet score.
Syntax
DELETE /api/v10/scoresheets/123/scores/321/date
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/v10/scoresheets/123/scores/321/date"Response headers
| Header | Value | Description |
|---|---|---|
Content-Type | text/plain | The media type of the resource |
Content-Length | 0 | The size of the response body in bytes |
Response codes
| Response code | Description |
|---|---|
204 No Content | The date was successfully cleared |
404 Not Found | The scoresheet does not have this score |