SimpleNotes - API v2

Multi-Note System with Folders

API v2 supports multiple notes organized in folders!

Quick Start

1. Get your API token from api.simplenotes.cc

2. Use the endpoints below to manage notes and folders

3. Response format: JSON (add &json=1) or XML (default)

Base URL

https://api.simplenotes.cc/v2/

Demo

Try the API v2 with this demo key:

Demo Key: QHAIVcQqpv0TDmFdEhaVoSRZM8tt1M9jBZgWcQMU19wRKXrDGIRDXoG5Ko5lB5

Account resets every 15 minutes. Contains: 3 folders (Main, To-do, Holiday) and 4 notes.

Endpoints

GET/POST /v2/get/ - Retrieve Notes & Folders

Examples (GET & POST supported):

# GET - All folders and notes
GET https://api.simplenotes.cc/v2/get/?key=YOUR_API_KEY&json=1

# GET - Specific note only
GET https://api.simplenotes.cc/v2/get/?key=YOUR_API_KEY¬e_id=123&json=1

# POST - Using cURL
curl -X POST https://api.simplenotes.cc/v2/get/ \
  -d "key=YOUR_API_KEY&json=1"

# POST - Using JavaScript fetch
fetch('https://api.simplenotes.cc/v2/get/', {
  method: 'POST',
  headers: {'Content-Type': 'application/x-www-form-urlencoded'},
  body: 'key=YOUR_API_KEY&json=1'
})

Response - All notes (JSON):

{
  "success": "1",
  "version": "2.0",
  "max": 500,
  "premium": 0,
  "share_active": 1,
  "share_url": "https://sl.simplenotes.cc/abc123",
  "folders": [
    {"id": 1, "name": "Main", "is_default": 1}
  ],
  "notes": [
    {"id": 1, "folder_id": 1, "title": "My Note", "content": "..."}
  ]
}

Response - Single note (JSON):

{
  "success": "1",
  "version": "2.0",
  "max": 500,
  "premium": 0,
  "note": {"id": 1, "folder_id": 1, "title": "My Note", "content": "..."}
}

Share Info (only in "all notes" response):

• share_active: 1 - Sharing is active, share_url contains the share link
• share_active: 0 - Sharing is inactive, share_url is "http://api.simplenotes.cc/v2/"

GET/POST /v2/send/ - Save/Create/Update Notes & Folders

Modes:

• Create note: Send title + content (without note_id)
• Update note: Send note_id + optional title/content
• Toggle sharing: Send only share=1 or share=0
• Manage folders: Send folder_action parameter

Examples (GET & POST supported):

# POST - Create new note (cURL)
curl -X POST https://api.simplenotes.cc/v2/send/ \
  -d "key=YOUR_API_KEY&title=My Note&content=Note content&folder_id=1"

# POST - Update note (JavaScript fetch)
fetch('https://api.simplenotes.cc/v2/send/', {
  method: 'POST',
  headers: {'Content-Type': 'application/x-www-form-urlencoded'},
  body: 'key=YOUR_API_KEY¬e_id=123&title=Updated&content=New content'
})

# POST - Create note with base64 content
curl -X POST https://api.simplenotes.cc/v2/send/ \
  -d "key=YOUR_API_KEY&title=Note&content=SGVsbG8gV29ybGQ=&b64=1"

# POST - Enable sharing (only)
curl -X POST https://api.simplenotes.cc/v2/send/ \
  -d "key=YOUR_API_KEY&share=1"

# POST - Create folder
curl -X POST https://api.simplenotes.cc/v2/send/ \
  -d "key=YOUR_API_KEY&folder_action=create&folder_name=Work Notes"

# POST - Delete folder
curl -X POST https://api.simplenotes.cc/v2/send/ \
  -d "key=YOUR_API_KEY&folder_action=delete&folder_id=2"

# POST - Delete single note
curl -X POST https://api.simplenotes.cc/v2/send/ \
  -d "key=YOUR_API_KEY&folder_action=delete_note¬e_id=5"

# POST - Move note to different folder
curl -X POST https://api.simplenotes.cc/v2/send/ \
  -d "key=YOUR_API_KEY&folder_action=move_note¬e_id=3&folder_id=2"

# GET - Also works with GET (not recommended for large content)
GET https://api.simplenotes.cc/v2/send/?key=YOUR_API_KEY&title=Test&content=Hello

Responses (JSON):

// Create note
{"success": "1", "action": "created", "note_id": 123, "folder_id": 1}

// Update note
{"success": "1", "action": "updated", "note_id": 123}

// Toggle sharing
{"success": "1", "action": "sharing_enabled"}
{"success": "1", "action": "sharing_disabled"}

// Folder operations
{"success": "1", "action": "folder_created", "folder_id": 5}
{"success": "1", "action": "folder_deleted", "folder_id": 2}
{"success": "1", "action": "note_deleted", "note_id": 5}
{"success": "1", "action": "note_moved", "note_id": 3, "folder_id": 2}

Character Limits

• Free: 500 characters
• Premium: 1500 characters

Premium: Click here

Data Structure

Folder:

{
  "id": 1,              // Folder ID
  "name": "Main",       // Folder name
  "is_default": 1       // Is default folder
}

Note:

{
  "id": 1,              // Note ID
  "folder_id": 1,       // Parent folder ID
  "title": "My Note",   // Note title
  "content": "..."      // Note content
}

Error Responses

// Error (JSON)
{"success": "0", "error": "Error message"}

// Error (XML)

  0
  Error message

Common errors: Invalid API key, Note not found, Content too long, Database connection failed

XML Response Example

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <success>1</success>
  <version>2.0</version>
  <max>500</max>
  <premium>0</premium>
  <share_active>1</share_active>
  <share_url>https://sl.simplenotes.cc/abc123</share_url>
  <folders>
    <item>
      <id>1</id>
      <name>Main</name>
      <is_default>1</is_default>
    </item>
  </folders>
  <notes>
    <item>
      <id>1</id>
      <folder_id>1</folder_id>
      <title>My Note</title>
      <content>Note content</content>
    </item>
  </notes>
</response>

Migration from API v1

API v1 endpoints still work at api.simplenotes.cc/get/ and api.simplenotes.cc/send/

API v1 uses legacy single-note structure. API v2 uses multi-note with folders.

Auto-Migration: When you generate a new API key, your old single-note is automatically migrated to the new system (folder "Main" + "Migrated Note").

Security

• Keep your API key secure - it cannot be reset!
• Don't share your API key with untrusted parties
• Use HTTPS for all API requests

ATTENTION: You have only one key that cannot be reset. Please don't lose it and don't share it!
In case of problems send an e-mail to admin@simplenotes.cc

Home | API v1 | Privacy Policy

© Hendrik Lüdtke. All rights reserved.