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

# Get Memories

> Fetch memories by ID.

## Overview

Returns the memories with the given IDs. When some IDs aren't found, the status is `207` with `status: "partial"` and the missing IDs in `not_found_ids`.

## Authentication

**x-api-key** `string` *required*

Your Memanto Cloud API key (`mk_...`). See [Authentication](https://docs.memanto.ai/cloud/api/introduction.md#authentication).

## Path Parameters

**agent\_id** `string` *required*

The agent's ID.

## Body

**ids** `array` *required*

Memory IDs to fetch.

`text` is the stored memory card: a `[TYPE] title` line, the content, and a `Tags:` line.

```bash cURL theme={null}
curl -X POST "https://api.memanto.ai/agents/my-agent/memories/get" \
  -H "x-api-key: $MEMANTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "3f2a9c1e-5b7d-4e2a-9c1e-5b7d4e2a9c1e"
    ]
  }'
```

```json 200 - OK theme={null}
{
  "status": "success",
  "message": "Successfully retrieved 1 items from agent 'my-agent'.",
  "requested_count": 1,
  "found_count": 1,
  "items": [
    {
      "id": "3f2a9c1e-5b7d-4e2a-9c1e-5b7d4e2a9c1e",
      "text": "[PREFERENCE] Dark mode\n\nThe user prefers dark mode\n\nTags: ui",
      "memory_type": "preference",
      "status": "active",
      "provenance": "explicit_statement",
      "source": "my-app",
      "title": "Dark mode",
      "confidence": 0.9,
      "tags": [
        "ui"
      ],
      "expired_at": null,
      "expired_by": null,
      "metadata": {
        "actor_id": "my-agent"
      }
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.