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

# Get Contact Memory

> Retrieve a contact's full memory record by ID, including their conversation summary, structured facts, recent messages, and open items.

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Path Parameters

<ParamField path="memory_id" type="string" required>
  The unique identifier of the contact memory record.
</ParamField>

### Response

<ResponseField name="data" type="object">
  The contact memory object.
</ResponseField>

<ResponseField name="data.id" type="string">
  Unique identifier for the contact memory.
</ResponseField>

<ResponseField name="data.org_id" type="string">
  Organization ID this memory belongs to.
</ResponseField>

<ResponseField name="data.contact_id" type="string">
  Contact ID this memory is associated with.
</ResponseField>

<ResponseField name="data.persona_id" type="string">
  Persona ID this memory is scoped to (null if agent-based).
</ResponseField>

<ResponseField name="data.agent_number" type="string">
  Agent phone number this memory is scoped to (null if persona-based).
</ResponseField>

<ResponseField name="data.summary" type="string">
  Rolling summary of interactions with this contact.
</ResponseField>

<ResponseField name="data.facts" type="object">
  Structured facts about the contact (key-value pairs).
</ResponseField>

<ResponseField name="data.recent_messages" type="array">
  Array of recent messages from the sliding window.
</ResponseField>

<ResponseField name="data.open_items" type="array">
  Array of open items or pending tasks.
</ResponseField>

<ResponseField name="data.memory_history" type="array">
  Historical record of memory updates.
</ResponseField>

<ResponseField name="data.created_at" type="string">
  ISO timestamp when the memory was created.
</ResponseField>

<ResponseField name="data.updated_at" type="string">
  ISO timestamp when the memory was last updated.
</ResponseField>

<ResponseField name="errors" type="null">
  Error array (null on success).
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": {
      "id": "mem-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "org_id": "11111111-2222-3333-4444-555555555555",
      "contact_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "persona_id": "persona-12345678",
      "agent_number": null,
      "summary": "Customer called about order #8821 which was delayed. Follow-up confirmed the order shipped and is now in transit.",
      "facts": {
        "name": "Sarah Chen",
        "phone": "+14155550192",
        "preferred_contact": "sms",
        "timezone": "America/Los_Angeles"
      },
      "recent_messages": [
        {
          "role": "user",
          "content": "Hi, has my order shipped yet?",
          "channel": "sms",
          "timestamp": "2025-07-23T09:10:00.000Z"
        },
        {
          "role": "assistant",
          "content": "Yes, order #8821 shipped this morning. Expected delivery is Friday July 25.",
          "channel": "sms",
          "timestamp": "2025-07-23T09:10:05.000Z"
        }
      ],
      "open_items": [
        {
          "type": "follow_up",
          "description": "Confirm delivery of order #8821 on July 25",
          "created_at": "2025-07-23T09:10:00.000Z",
          "priority": "medium",
          "related_to": {
            "entity_type": "order",
            "entity_id": "order-8821"
          }
        }
      ],
      "memory_history": [],
      "created_at": "2025-07-20T10:30:00.000Z",
      "updated_at": "2025-07-23T09:15:00.000Z"
    },
    "errors": null
  }
  ```

  ```json Not Found theme={null}
  {
    "data": null,
    "errors": [
      {
        "error": "NOT_FOUND",
        "message": "Contact memory not found"
      }
    ]
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)