Offer notes
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 notes added to an offer.
URI
/api/v10/applications/ID/offers/ID/notesThe PUT /api/applications/ID/offers/ID/notes request was discontinued starting from version 6. To add a new note, use the POST method instead. For backwards compatibility, the PATCH method is supported, but is deprecated.
GET List offer notes
List all offer notes — text messages (sticky notes) added to the offer card.
Syntax
GET /api/v10/applications/123/offers/321/notes
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/applications/123/offers/321/notes"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 |
X-Count | 2 | The number of notes for this offer |
Response codes
| Response code | Description |
|---|---|
200 OK | The list of notes was successfully returned |
404 Not Found | The application does not have this offer |
Example response
Response
{
"144": {
"created": "2025-12-10T11:55:57+00:00",
"removed": null,
"colour": "Salmon",
"pinned": false,
"collapsed": false,
"notes": "Need to receive updated proof of financial support documents"
},
"145": {
"created": "2025-12-10T11:56:13+00:00",
"removed": null,
"colour": "Orange",
"pinned": false,
"collapsed": false,
"notes": "Follow up on the missing final high school transcript"
}
}Response
"Need to receive updated proof of financial support documents -- Follow up on the missing final high school transcript"POST Add an offer note
Create a new note for an offer.
Syntax
POST /api/v10/applications/123/offers/321/notes
Host: apply.example.edu
Authorization: DREAM apikey="..."Parameters
| Name | Required/Optional | Description | Notes |
|---|---|---|---|
colour | Optional | The colour of the sticky note. Allowed values: Yellow, Orange, Salmon, Green, Blue, Violet. | - |
color | Optional | An alias for colour. | If both colour and color values are specified, the colour value is preferred. |
Raw request body
The request body must contain a proper JSON string literal that meets the following requirements:
- The value must be enclosed in double quotes, for example,
"Some note", notSome note. - According to the JSON specification, only spaces are allowed. Other characters, such as new lines (
\n) and quotation marks (\"), must be encoded.
Request body
"The first line in the note\nThe second line in the note"Example request
Request
curl
curl \
-X POST \
-H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
-d '"The first line in the note\nThe second line in the note"' \
"https://apply.example.edu/api/v10/applications/123/offers/321/notes"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 notes were successfully saved. |
400 Bad Request | Invalid notes. Please make sure that status is a valid JSON string with quotes. |
404 Not Found | The application does not have this offer. |