Fetch Single Note

Retrieve a single note by its NoteToken. The note content is automatically decrypted before being returned.

POST https://api-v3.sweeppea.com/notes/single

Description

This endpoint retrieves a single note owned by the authenticated user. The note is identified by its NoteToken and can only be fetched by the user who created it. The Note field is automatically decrypted before being returned.

Authentication

This endpoint requires Bearer token authentication via the Authorization header.

Request Body

Field	Type	Required	Description
`NoteToken`	String	Yes	Unique identifier of the note to retrieve (UUID v4)

Code Examples

curl -X POST "https://api-v3.sweeppea.com/notes/single" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"NoteToken":"uuid-v4-string"}'

const response = await fetch('https://api-v3.sweeppea.com/notes/single', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    NoteToken: 'uuid-v4-string'
  })
});

const data = await response.json();
console.log(data);

import requests

url = "https://api-v3.sweeppea.com/notes/single"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "NoteToken": "uuid-v4-string"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

Response

{
  "Response": true,
  "Data": {
    "_id": "68df07e9896a685bf51d58cf",
    "NoteToken": "uuid-v4-string",
    "Title": "Example Note",
    "Note": "Decrypted note content",
    "Views": 0,
    "Pinned": false,
    "Status": false,
    "CreatedByAdmin": false,
    "CreationDate": "2025-10-02T23:16:57.491Z"
  }
}

Error Responses

{
  "Response": false,
  "Message": "NoteToken is Required",
  "Help": {
    "ExpectedBody": {
      "NoteToken": "string (required) \u2014 UUID v4 of the note"
    }
  },
  "Code": 400
}

{
  "Response": false,
  "Message": "Missing or invalid Bearer token. Send your API token in the Authorization header as: Authorization: Bearer YOUR_API_TOKEN",
  "Code": 401
}

{
  "Response": false,
  "Message": "Invalid API token. It does not match any account.",
  "Code": 403
}

{
  "Response": false,
  "Message": "Note Not Found",
  "Code": 404
}

{
  "Response": false,
  "Message": "Internal server error. Please try again; if it persists, contact support with the time of this request.",
  "Code": 500
}

Important Notes

🔒 Ownership Verification: Users can only fetch notes they own
🔓 Auto Decryption: The Note field is stored encrypted and automatically decrypted in the response
🆔 Note Identification: Notes are identified by their unique NoteToken (UUID v4)
🔍 Not Found: Returns 404 if the note doesn't exist or belongs to another user