Skip to main content
GET
/
v1
/
memory
/
contact
/
{memory_id}
/
messages
List Recent Messages
curl --request GET \
  --url https://api.bland.ai/v1/memory/contact/{memory_id}/messages \
  --header 'authorization: <authorization>'
{
  "data": [
    {
      "role": "user",
      "content": "Hi, I'm calling about my order",
      "channel": "call",
      "timestamp": "2025-07-22T10:30:00.000Z"
    },
    {
      "role": "assistant",
      "content": "I'd be happy to help you with your order. Can you provide your order number?",
      "channel": "call",
      "timestamp": "2025-07-22T10:30:05.000Z"
    },
    {
      "role": "user",
      "content": "It's order #12345",
      "channel": "sms",
      "timestamp": "2025-07-22T11:00: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
array
Array of recent messages.
​
data[].role
string
Message role: “user” or “assistant”.
​
data[].content
string
Message content.
​
data[].channel
string
Channel the message came from: “call” or “sms”.
​
data[].timestamp
string
ISO timestamp when the message was recorded.
​
errors
null
Error array (null on success).
{
  "data": [
    {
      "role": "user",
      "content": "Hi, I'm calling about my order",
      "channel": "call",
      "timestamp": "2025-07-22T10:30:00.000Z"
    },
    {
      "role": "assistant",
      "content": "I'd be happy to help you with your order. Can you provide your order number?",
      "channel": "call",
      "timestamp": "2025-07-22T10:30:05.000Z"
    },
    {
      "role": "user",
      "content": "It's order #12345",
      "channel": "sms",
      "timestamp": "2025-07-22T11:00:00.000Z"
    }
  ],
  "errors": null
}
Docs for agents: llms.txt