> ## Documentation Index
> Fetch the complete documentation index at: https://docs.remem.online/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /memories — List All Memories for a User Agent

> Browse every stored memory for a user and agent pair, sorted most-recent first. Supports type filtering and limit/offset pagination for large memory sets.

The List Memories endpoint returns every memory stored for a given `user_id` and `agent_id`, ordered from most recent to oldest. You can use it to build a memory browser in your dashboard, audit what your agent knows about a user, or debug unexpected behaviour. Combine `limit` and `offset` to page through large memory sets without loading everything at once.

<Note>
  **Endpoint:** `GET https://api.remem.online/memories`
</Note>

## Request Headers

| Name        | Required | Description        |
| ----------- | -------- | ------------------ |
| `X-API-Key` | Yes      | Your Remem API key |

## Query Parameters

<ParamField query="user_id" type="string" required>
  The ID of the user whose memories you want to list.
</ParamField>

<ParamField query="agent_id" type="string" required>
  The ID of the agent whose memories you want to list.
</ParamField>

<ParamField query="memory_type" type="string">
  Filter results to a specific memory type. Accepted values: `episodic`, `semantic`, `summary`. Omit to return all types.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Number of memories to return per page. Minimum `1`, maximum `100`.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Zero-based pagination offset. Use in combination with `limit` to step through pages.
</ParamField>

## Examples

<CodeGroup>
  ```bash curl theme={null}
  curl "https://api.remem.online/memories?\
  user_id=user_123&agent_id=support_bot&limit=20&offset=0" \
    -H "X-API-Key: rm_live_xxx"
  ```

  ```python Python SDK theme={null}
  from remem import RememClient

  client = RememClient(api_key="rm_live_xxx")

  # First page
  page = client.list(
      user_id="user_123",
      agent_id="support_bot",
      limit=20,
      offset=0,
  )

  print(f"Total memories: {page.total}")
  for m in page.memories:
      print(m.content, m.created_at)

  # Second page
  page2 = client.list(
      user_id="user_123",
      agent_id="support_bot",
      limit=20,
      offset=20,
  )
  ```
</CodeGroup>

## Response

### 200 — Success

```json theme={null}
{
  "memories": [
    {
      "id":          "775263ee-73af-4416-9804-1f274048ae08",
      "content":     "User prefers concise bullet points",
      "user_id":     "user_123",
      "agent_id":    "support_bot",
      "memory_type": "semantic",
      "importance":  0.8,
      "metadata":    {},
      "created_at":  "2026-06-07T12:00:00Z",
      "last_accessed": "2026-06-07T12:00:00Z",
      "expires_at":  null
    }
  ],
  "total":  47,
  "limit":  20,
  "offset": 0
}
```

### Response Fields

<ResponseField name="memories" type="array">
  Array of Memory objects. See [Search Memories](/api-reference/search) for the full Memory object field reference.
</ResponseField>

<ResponseField name="total" type="integer">
  Total number of memories stored for this user+agent pair across all pages.
</ResponseField>

<ResponseField name="limit" type="integer">
  The `limit` value applied to this response.
</ResponseField>

<ResponseField name="offset" type="integer">
  The `offset` value applied to this response.
</ResponseField>

## Error Responses

| Code  | Meaning                    | Fix                                                 |
| ----- | -------------------------- | --------------------------------------------------- |
| `401` | Invalid or missing API key | Verify your key is passed in the `X-API-Key` header |
| `422` | Missing required parameter | Both `user_id` and `agent_id` are required          |