Get User Memory Details
curl --request POST \
--url https://api.bland.ai/v1/memory/{memory_id}/user \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"phone_number": "<string>",
"external_memory_key": "<string>"
}
'import requests
url = "https://api.bland.ai/v1/memory/{memory_id}/user"
payload = {
"phone_number": "<string>",
"external_memory_key": "<string>"
}
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({phone_number: '<string>', external_memory_key: '<string>'})
};
fetch('https://api.bland.ai/v1/memory/{memory_id}/user', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v1/memory/{memory_id}/user",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'phone_number' => '<string>',
'external_memory_key' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/memory/{memory_id}/user"
payload := strings.NewReader("{\n \"phone_number\": \"<string>\",\n \"external_memory_key\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bland.ai/v1/memory/{memory_id}/user")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"phone_number\": \"<string>\",\n \"external_memory_key\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/memory/{memory_id}/user")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"phone_number\": \"<string>\",\n \"external_memory_key\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"metadata": "25 year old customer from New York",
"summary": "The user had previously discussed their startup and had a follow-up conversation, asking questions about AI and the future of their business.",
"last_call_at": "2025-07-22T05:19:46.000Z",
"call_count": 1,
"calls": [
{
"c_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeffffgggg",
"created_at": "2025-07-22T05:19:37.314Z",
"summary": "The call appears to be a follow-up conversation about the user's startup, asking questions about AI and the future of their business.",
"answered_by": "human",
"call_length": 0.3,
"inbound": false
}
]
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "MEMORY_ERROR",
"message": "Failed to retrieve memory data."
}
]
}
User Management
Get User Memory Details
Retrieve detailed memory information for a specific user or phone number in a memory store.
POST
/
v1
/
memory
/
{memory_id}
/
user
Get User Memory Details
curl --request POST \
--url https://api.bland.ai/v1/memory/{memory_id}/user \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"phone_number": "<string>",
"external_memory_key": "<string>"
}
'import requests
url = "https://api.bland.ai/v1/memory/{memory_id}/user"
payload = {
"phone_number": "<string>",
"external_memory_key": "<string>"
}
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({phone_number: '<string>', external_memory_key: '<string>'})
};
fetch('https://api.bland.ai/v1/memory/{memory_id}/user', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v1/memory/{memory_id}/user",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'phone_number' => '<string>',
'external_memory_key' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/memory/{memory_id}/user"
payload := strings.NewReader("{\n \"phone_number\": \"<string>\",\n \"external_memory_key\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bland.ai/v1/memory/{memory_id}/user")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"phone_number\": \"<string>\",\n \"external_memory_key\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/memory/{memory_id}/user")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"phone_number\": \"<string>\",\n \"external_memory_key\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"metadata": "25 year old customer from New York",
"summary": "The user had previously discussed their startup and had a follow-up conversation, asking questions about AI and the future of their business.",
"last_call_at": "2025-07-22T05:19:46.000Z",
"call_count": 1,
"calls": [
{
"c_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeffffgggg",
"created_at": "2025-07-22T05:19:37.314Z",
"summary": "The call appears to be a follow-up conversation about the user's startup, asking questions about AI and the future of their business.",
"answered_by": "human",
"call_length": 0.3,
"inbound": false
}
]
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "MEMORY_ERROR",
"message": "Failed to retrieve memory data."
}
]
}
Headers
string
required
Your API key for authentication.
Path Parameters
string
required
The unique identifier of the memory.
Body Parameters
string
required
The phone number of the user to retrieve memory details for.
string
Optional external key for additional memory validation or cross-referencing.
Response
object
User memory data.
string
Custom metadata text associated with this user’s memory entry.
string
AI-generated summary of interactions with this user.
string
ISO timestamp of the most recent call with this user.
number
Total number of calls with this user.
array
Array of call objects associated with this user.
string
Unique identifier for the call.
string
ISO timestamp when the call was made.
string
AI-generated summary of this specific call.
string
Who answered the call (e.g., “human”, “ai”).
number
Call duration in minutes.
boolean
Whether this was an inbound call (true) or outbound call (false).
null
Error array (null on success).
{
"data": {
"metadata": "25 year old customer from New York",
"summary": "The user had previously discussed their startup and had a follow-up conversation, asking questions about AI and the future of their business.",
"last_call_at": "2025-07-22T05:19:46.000Z",
"call_count": 1,
"calls": [
{
"c_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeffffgggg",
"created_at": "2025-07-22T05:19:37.314Z",
"summary": "The call appears to be a follow-up conversation about the user's startup, asking questions about AI and the future of their business.",
"answered_by": "human",
"call_length": 0.3,
"inbound": false
}
]
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "MEMORY_ERROR",
"message": "Failed to retrieve memory data."
}
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I