Skip to main content
GET
/
v1
/
memory
/
contact
/
{memory_id}
Get Contact Memory
curl --request GET \
  --url https://api.bland.ai/v1/memory/contact/{memory_id} \
  --header 'authorization: <authorization>'
{
  "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
}

​
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).
{
  "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
}
Docs for agents: llms.txt