Get Contact Memory

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

GET /v1/memory/contact/{memory_id}

Get Contact Memory

cURL

curl --request GET \
  --url https://api.bland.ai/v1/memory/contact/{memory_id} \
  --header 'authorization: <authorization>'

Response

{
  "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": "[phone]",
      "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
}

Headers

authorization · string · required

Your API key for authentication.

Path Parameters

memory_id · string · required

The unique identifier of the contact memory record.

Response

data · object

The contact memory object.

data.id · string

Unique identifier for the contact memory.

data.org_id · string

Organization ID this memory belongs to.

data.contact_id · string

Contact ID this memory is associated with.

data.persona_id · string

Persona ID this memory is scoped to (null if agent-based).

data.agent_number · string

Agent phone number this memory is scoped to (null if persona-based).

data.summary · string

Rolling summary of interactions with this contact.

data.facts · object

Structured facts about the contact (key-value pairs).

data.recent_messages · array

Array of recent messages from the sliding window.

data.open_items · array

Array of open items or pending tasks.

data.memory_history · array

Historical record of memory updates.

data.created_at · string

ISO timestamp when the memory was created.

data.updated_at · string

ISO timestamp when the memory was last updated.

errors · null

Error array (null on success).

Response

{
  "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": "[phone]",
      "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
}