‍

Buddi API documentations

The Get Memories API retrieves the most recent memories for the user associated with the provided API key. Memories are returned in reverse chronological order (latest first). You can optionally filter the results by a specific date, and pagination is supported via the cursor parameter.

‍

Authentication

This endpoint requires a valid API key passed in the api-key HTTP header. API keys can be generated

from the Buddi app under Developer Settings.

‍

‍

Example Header : 

api-key: your_api_key_here

‍

Query Parameters

‍

‍

Responses

‍

200 OK - Returns an array of decrypted memory objects and a next_cursor token

Example 200 Response:

{ "memories": [ { "id": "abc123", "title": "Meeting Notes", "text": "Discussed project
timeline...", "created_at": "2025-08-11T09:12:00Z" }, { "id": "def456", "title": "Daily
Reflection", "text": "Had a productive day.", "created_at": "2025-08-11T07:00:00Z" } ],
"next_cursor": "def456" }

‍

400 Bad Request - Returned when the date parameter format is invalid.

Example:

{"detail": "Invalid date format, expected YYYY-MM-DD"}

‍

401 Unauthorized - Returned when the API key is missing or invalid.

Example:

{"detail": "Field required"}

‍

Example Usage

‍

Fetch the latest 5 memories

curl -X GET "https://apis.getbuddi.ai/v1/dev/get_memories?limit=5" \ -H 
"api-key: your_api_key_here"

‍

Fetch all memories from a specific date

curl -X GET "https://apis.getbuddi.ai/v1/dev/get_memories?date=2025-08-10" \ -H
"api-key: your_api_key_here"

‍

Fetch the next page using the cursor

curl -X GET "https://apis.getbuddi.ai/v1/dev/get_memories?limit=5&cursor;=def456" \ -H
"api-key: your_api_key_here"

‍