---
schema_version: "1"
id: 6f797b89296d68317a8d54f2f061bd51636497f8ffec9d022298f99a00f9a34d
title: Read Memories
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/agentic-memory-context/references/agentic-memory-context-ref/agentic-memory-api-read-memories.md
canonical_url: https://developer.salesforce.com/docs/data/agentic-memory-context/references/agentic-memory-context-api-ref/agentic-memory-api-read-memories.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 99729a3f1c1d7e8892405e65d47ac70c67e312a6d27e68d6535fe9af476e82e6
products:
  - Agentic Memory & Context
  - Data 360 Developer Documentation
---
# Read Memories

Retrieve memory entries for a profile, filtered by category.

**URI:** `/api/v1/agentic/memory`

**HTTP Method:** `GET`

**Authentication:** Bearer JWT

## Query Parameters

| Parameter    | Type   | Required | Description                                             |
| ------------ | ------ | -------- | ------------------------------------------------------- |
| profile_id   | String | Yes      | Profile ID of the Individual or User.                   |
| profile_type | String | Yes      | Type of profile. Values: `individual`, `employee`.      |
| category     | String | Yes      | Partition key that filters the returned memory entries. |

## Request Headers

| Header        | Required | Description       |
| ------------- | -------- | ----------------- |
| Authorization | Yes      | Bearer JWT token. |

## Response Body Schema

| Field               | Type   | Description                     |
| ------------------- | ------ | ------------------------------- |
| memories            | Array  | The matching memory entries.    |
| memories[].memoryId | String | Identifier of the memory entry. |
| memories[].content  | String | Memory content.                 |

### Example Response

**Status:** `200 OK`

```json
{
  "memories": [
    { "memoryId": "mem_abc123", "content": "Prefers EST scheduling" },
    { "memoryId": "mem_def456", "content": "Allergic to peanuts" }
  ]
}
```

## Error Codes

| Status Code | Description                                                       |
| ----------- | ----------------------------------------------------------------- |
| 400         | Bad Request. Invalid query parameters or missing required fields. |
| 401         | Unauthorized. Invalid or missing JWT token.                       |
| 500         | Internal Server Error.                                            |