Skip to main content
GET
/
v1
/
memory
/
changes
Get Memory Changes
curl --request GET \
  --url https://api.bland.ai/v1/memory/changes \
  --header 'authorization: <authorization>'
{
  "data": {
    "initial_memory": {
      "summary": "Customer previously inquired about pricing.",
      "facts": {
        "name": "John Doe"
      }
    },
    "changes": {
      "summary": "Customer placed an order for the premium plan. Order #12345 confirmed.",
      "facts": {
        "name": "John Doe",
        "plan": "premium",
        "order_id": "12345"
      }
    },
    "memory_history": [
      {
        "timestamp": "2025-07-22T10:30:00.000Z",
        "type": "summary_update",
        "value": "Customer placed an order for the premium plan."
      }
    ]
  },
  "errors": null
}

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Query Parameters

​
call_id
string
The call ID to get memory changes for. Either call_id or conversation_id is required.
​
conversation_id
string
The SMS conversation ID to get memory changes for. Either call_id or conversation_id is required.

​
Response

​
data
object
Memory changes data.
​
data.initial_memory
object
The memory context at the start of the interaction.
​
data.changes
object
Changes made to memory during the interaction.
​
data.memory_history
array
Historical record of memory updates.
​
errors
null
Error array (null on success).
{
  "data": {
    "initial_memory": {
      "summary": "Customer previously inquired about pricing.",
      "facts": {
        "name": "John Doe"
      }
    },
    "changes": {
      "summary": "Customer placed an order for the premium plan. Order #12345 confirmed.",
      "facts": {
        "name": "John Doe",
        "plan": "premium",
        "order_id": "12345"
      }
    },
    "memory_history": [
      {
        "timestamp": "2025-07-22T10:30:00.000Z",
        "type": "summary_update",
        "value": "Customer placed an order for the premium plan."
      }
    ]
  },
  "errors": null
}
Docs for agents: llms.txt