Skip to main content
GET
https://api.bland.ai
/
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 inquired about order status. Order #12345 is in transit.",
    "facts": {
      "name": "John Doe",
      "preferred_contact": "phone"
    },
    "recent_messages": [
      {
        "role": "user",
        "content": "Hi, I'm calling about my order",
        "channel": "call",
        "timestamp": "2025-07-22T10:30:00.000Z"
      }
    ],
    "open_items": [],
    "memory_history": [],
    "created_at": "2025-07-20T10:30:00.000Z",
    "updated_at": "2025-07-22T15:45: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 inquired about order status. Order #12345 is in transit.",
    "facts": {
      "name": "John Doe",
      "preferred_contact": "phone"
    },
    "recent_messages": [
      {
        "role": "user",
        "content": "Hi, I'm calling about my order",
        "channel": "call",
        "timestamp": "2025-07-22T10:30:00.000Z"
      }
    ],
    "open_items": [],
    "memory_history": [],
    "created_at": "2025-07-20T10:30:00.000Z",
    "updated_at": "2025-07-22T15:45:00.000Z"
  },
  "errors": null
}