Get note by ID
Retrieve a note by its ID.
Query Parameters
Default value: true
Specifies whether to include attached entities in the response, defaults to true.
- 200
- 400
- 401
- 403
- 404
- 422
- 429
- 500
- 502
- 503
- 504
Request has been handled successfully.
Schema
- Array [
- ]
data object
The unique identifier of the note.
The creation date of the note.
The last update date of the note.
Possible values: >= 6 characters
and <= 10000 characters
The main content of the note, must be between the specified minimum and maximum length.
The source of the note.
attachedEntities object[]
An array of attached entities associated with the note.
The unique identifier for the attached entity.
Possible values: [reflection
]
The type of the attached entity, must be one of the predefined NoteEntityType values.
entityMetadata object
Additional metadata for the attached entity.
Possible values: Value must match regular expression ^(\d+):(\d+)-(\d+):(\d+)$
An array of verse ranges associated with the note.
{
"success": true,
"data": {
"id": "asdasdqwe1231",
"createdAt": "2023-01-21T07:28:13.023Z",
"updatedAt": "2023-01-22T07:28:13.023Z",
"body": "This is a sample note body.",
"source": "we23412312weq",
"attachedEntities": [
{
"entityId": "entity123",
"entityType": "reflection",
"entityMetadata": {
"key": "value"
}
}
],
"ranges": [
"2:255-2:257"
]
}
}
The request is missing required parameters or is invalid.
Schema
{
"message": "The request is missing required headers or is invalid",
"type": "invalid_request",
"success": false
}
The request is unauthorized.
Schema
{
"message": "The request requires user authentication",
"type": "unauthorized",
"success": false
}
Forbidden error. Can either be due to access token not being passed, having been expired or the caller trying to access a resource without enough permissions.
Schema
{
"message": "The server understood the request, but refuses to authorize it",
"type": "forbidden",
"success": false
}
Not Found. The resource being accessed does not exist.
Schema
{
"message": "The requested resource could not be found",
"type": "not_found",
"success": false
}
Validation Error. The request includes one or more invalid params. Please check the request params and try again.
Schema
{
"message": "The request was well-formed but was unable to be followed due to semantic errors",
"type": "unprocessable_entity",
"success": false
}
Too many requests, please try again later.
Schema
{
"message": "Too many requests, please try again later",
"type": "rate_limit_exceeded",
"success": false
}
Server Error. Something went wrong, try again later.
Schema
{
"message": "The server encountered an internal error and was unable to complete your request",
"type": "internal_server_error",
"success": false
}
Invalid response from the upstream server
Schema
{
"message": "The server was acting as a gateway or proxy and received an invalid response from the upstream server",
"type": "bad_gateway",
"success": false
}
The server is currently unable to handle the request due to a temporary overload or scheduled maintenance
Schema
{
"message": "The server is currently unable to handle the request due to a temporary overload or scheduled maintenance",
"type": "service_unavailable",
"success": false
}
The server did not receive a timely response from the upstream server.
Schema
{
"message": "The server was acting as a gateway or proxy and did not receive a timely response from the upstream server",
"type": "gateway_timeout",
"success": false
}