GET
/
memories
curl --request GET \
  --url https://v2.api.supermemory.ai/memories \
  --header 'x-api-key: <api-key>'
{
  "memories": [
    {
      "id": "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",
      "url": "https://example.com/article",
      "content": "This is a detailed article about machine learning concepts..."
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 10,
    "limit": 10,
    "totalItems": 100
  }
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
page
string
default:1

Page number to fetch

Example:

"1"

​
limit
string
default:10

Number of items per page

Example:

"10"

​
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

​
memories
object[]
required

Memory object

​
pagination
object
required

Pagination metadata

Example:
{
  "currentPage": 1,
  "totalPages": 10,
  "limit": 10,
  "totalItems": 100
}