---
title: "List memories"
method: GET
path: "/memories"
tags: ["memories"]
---

# List memories

`GET /memories`

List memories with pagination and filtering options.

## Query parameters

- `page` integer — Page number
- `size` integer — Page size
- `sort_by` string — Field to sort by
- `sort_order` string — Sort order (asc or desc)
- `tags` string[], nullable — Filter by tags
- `source` string, nullable — Filter by source
- `min_importance` integer, nullable — Minimum importance
- `space_id` string, nullable — Space ID to list memories from

## Response `200`

Paginated list of memories

- MemoryList — Paginated list of memories.
  - `items` Memory[], required
    - `content` string, required — Memory content text
    - `tags` string[], nullable — Tags for categorizing the memory
    - `source` string, nullable — Source of the memory
    - `importance` integer, nullable — Importance score (1-10)
    - `category` string, nullable — Memory category within space
    - `metadata` object, nullable — Additional metadata
    - `id` string, required — Unique identifier
    - `created_at` string, date-time, required — Creation timestamp
    - `updated_at` string, date-time, nullable — Last update timestamp
    - `created_by_user` string, required — User who created this memory
    - `space_id` string, nullable — Space this memory belongs to
    - `space_name` string, nullable — Name of the space
    - `tenant_id` string, nullable — Legacy tenant identifier
    - `full_content` string, nullable — Complete original content (internal use)
    - `is_chunk` boolean — Whether this memory is a chunk of larger content
    - `parent_memory_id` string, nullable — ID of parent memory if this is a chunk
    - `chunk_index` integer, nullable — Index of this chunk within parent memory
    - `total_chunks` integer, nullable — Total number of chunks in parent memory
    - `chunk_metadata` object, nullable — Chunk-specific metadata
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required
  - `pages` integer, required

## Other responses

- `401` — Unauthorized
- `413` — Request Entity Too Large
- `422` — Validation Error

---

[API](https://skmtc.net/memara/apis/memara-api.md) · [All operations](https://skmtc.net/memara/apis/memara-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/memara/memara-api/revisions/4dc7c4418845/schema)