List Memories

Retrieve all stored memories for the authenticated user.

Endpoint

GET https://api.memory.audaxic.com/list

Query Parameters

No request body required. The endpoint uses your API key to identify your user context. Use limit and offset to paginate through all memories.

Field	Type	Required	Description
limit	number	No	Max memories to return (1-100, default: 50)
offset	number	No	Number of memories to skip (default: 0). Results are created_at DESC, id ASC — increment by limit to paginate (?limit=50&offset=0, ?limit=50&offset=50, ...)

Paginate until memories.length < limit to list all memories for the project.

Response

{
  "memories": [
    {
      "id": "mem_abc123",
      "memory": "User prefers dark mode and uses VS Code",
      "metadata": {}
    },
    {
      "id": "mem_def456",
      "memory": "User's favorite programming language is Rust",
      "metadata": {}
    }
  ]
}

Field	Type	Description
memories	MemoryItem[]	All stored memories for your user
memories[].id	string	Unique memory identifier
memories[].memory	string	The stored memory text
memories[].metadata	object	Associated metadata

Examples

cURL

curl https://api.memory.audaxic.com/list \
  -H "Authorization: Bearer ak_your_api_key"

Paginate with limit and offset:

curl "https://api.memory.audaxic.com/list?limit=2&offset=2" \
  -H "Authorization: Bearer ak_your_api_key"

JavaScript

const response = await fetch("https://api.memory.audaxic.com/list", {
  headers: {
    Authorization: "Bearer ak_your_api_key",
  },
});

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

// Paginated
const paged = await fetch("https://api.memory.audaxic.com/list?limit=50&offset=50", {
  headers: { Authorization: "Bearer ak_your_api_key" },
}).then(r => r.json());

Python

import requests

response = requests.get(
    "https://api.memory.audaxic.com/list",
    headers={"Authorization": "Bearer ak_your_api_key"},
)

data = response.json()
print(data["memories"])

# List all with pagination
memories = []
limit, offset = 50, 0
while True:
    r = requests.get(
        f"https://api.memory.audaxic.com/list?limit={limit}&offset={offset}",
        headers={"Authorization": "Bearer ak_your_api_key"},
    )
    batch = r.json()["memories"]
    memories.extend(batch)
    if len(batch) < limit:
        break
    offset += limit