curl --request GET \
--url https://api.example.com/api/notes \
--header 'Authorization: <authorization>'{
"message": "<string>",
"data": [
{
"id": 123,
"title": "<string>",
"data": {},
"description": {},
"thumbnail": {},
"views": 123,
"visibility": "<string>",
"ownerId": 123,
"createdAt": "<string>",
"updatedAt": "<string>",
"owner": {
"id": 123,
"email": "<string>",
"username": "<string>"
},
"sharedStatuses": [
{
"id": 123,
"sharedById": 123,
"sharedWithId": 123,
"permissions": "<string>",
"noteId": 123,
"sharedAt": "<string>"
}
],
"likes": [
{}
],
"comments": [
{}
]
}
]
}Retrieve notes based on query parameters - user’s own notes, a specific note, shared notes, or public notes
curl --request GET \
--url https://api.example.com/api/notes \
--header 'Authorization: <authorization>'{
"message": "<string>",
"data": [
{
"id": 123,
"title": "<string>",
"data": {},
"description": {},
"thumbnail": {},
"views": 123,
"visibility": "<string>",
"ownerId": 123,
"createdAt": "<string>",
"updatedAt": "<string>",
"owner": {
"id": 123,
"email": "<string>",
"username": "<string>"
},
"sharedStatuses": [
{
"id": 123,
"sharedById": 123,
"sharedWithId": 123,
"permissions": "<string>",
"noteId": 123,
"sharedAt": "<string>"
}
],
"likes": [
{}
],
"comments": [
{}
]
}
]
}shared - Returns notes that have been shared with the authenticated userfeatured - Returns all public notesid nor type is provided, returns all notes owned by the authenticated user.id)curl -X GET https://api.noteverse.com/api/notes \
-H "Authorization: Bearer YOUR_AUTH_TOKEN"
{
"message": "Notes fetched successfully",
"data": [
{
"id": 123,
"title": "My Note",
"data": "Note content here",
"description": null,
"thumbnail": null,
"views": 15,
"visibility": "Private",
"createdAt": "2026-03-01T10:30:00.000Z",
"updatedAt": "2026-03-02T14:20:00.000Z",
"ownerId": 42,
"categoryId": null,
"subcategoryId": null,
"owner": {
"id": 42,
"email": "user@example.com",
"username": "john_doe",
"password": "hashed_password",
"authToken": "token",
"emailVerified": true,
"verificationToken": null
},
"sharedStatuses": [],
"likes": []
}
]
}
{
"message": "Notes fetched successfully",
"data": {
"id": 123,
"title": "Shared Note",
"data": "Content of shared note",
"description": "A note shared with me",
"thumbnail": null,
"views": 5,
"visibility": "Shared",
"createdAt": "2026-02-15T08:00:00.000Z",
"updatedAt": "2026-02-20T12:00:00.000Z",
"ownerId": 10,
"owner": {
"id": 10,
"email": "owner@example.com",
"username": "note_owner"
},
"sharedStatuses": [
{
"id": 1,
"sharedById": 10,
"sharedWithId": 42,
"permissions": "Edit",
"noteId": 123,
"sharedAt": "2026-02-16T09:00:00.000Z"
}
]
}
}
{
"error": "Invalid or expired token"
}
{
"error": "Notes not found"
}
id, the user must either:type=featured query returns all public notes in the system, which may be a large dataset. Consider implementing pagination for production use.