GET
/
v3
/
memories
curl --request GET \
  --url https://api.supermemory.ai/v3/memories \
  --header 'Authorization: Bearer <token>'
{
  "memories": [
    {
      "id": "acxV5LHMEsG2hMSNb4umbn",
      "customId": "mem_abc123",
      "title": "Introduction to Machine Learning",
      "summary": "A comprehensive guide to understanding the basics of machine learning and its applications.",
      "metadata": {
        "source": "web",
        "category": "technology",
        "tag_1": "ai",
        "tag_2": "machine-learning",
        "readingTime": 5,
        "isPublic": true
      },
      "createdAt": "1970-01-01T00:00:00.000Z",
      "updatedAt": "1970-01-01T00:00:00.000Z",
      "status": "done",
      "containerTags": [
        "user_123",
        "project_123"
      ]
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 10,
    "limit": 10,
    "totalItems": 100
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
page
string
default:1

Page number to fetch

Example:

"1"

​
limit
string
default:10

Number of items per page

Example:

"10"

​
containerTags
string[]

Optional tags this memory should be containerized by. This can be an ID for your user, a project ID, or any other identifier you wish to use to group memories.

Example:
["user_123", "project_123"]
​
sort
enum<string>
default:createdAt

Field to sort by

Available options:
createdAt,
updatedAt
Example:

"createdAt"

​
order
enum<string>
default:desc

Sort order

Available options:
asc,
desc
Example:

"desc"

​
filters
string

Optional filters to apply to the search

Example:

"{\"AND\":[{\"key\":\"group\",\"value\":\"jira_users\",\"negate\":false},{\"filterType\":\"numeric\",\"key\":\"timestamp\",\"value\":\"1742745777\",\"negate\":false,\"numericOperator\":\">\"}]}"

Response

200
application/json

Successfully retrieved memories

List of memories