Get Memory Details
curl --request GET \
--url https://api.bland.ai/v1/memory/{memory_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/memory/{memory_id}"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/memory/{memory_id}', 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}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/memory/{memory_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bland.ai/v1/memory/{memory_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/memory/{memory_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"data": {
"memory_id": "12345678-1234-1234-1234-123456789012",
"name": "Customer Support",
"created_at": "2025-07-20T23:32:19.840Z",
"users": [
{
"phone_number": "+12345678900",
"created_at": "2025-07-21T07:09:04.372Z",
"call_count": 0,
"metadata": "25 year old customer from New York",
"last_call_at": null,
"summary": "Previous call discussion was on the topic of startups"
}
]
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "MEMORY_NOT_FOUND",
"message": "Memory not found."
}
]
}
{
"data": null,
"errors": [
{
"error": "MEMORY_ERROR",
"message": "Failed to retrieve memory data."
}
]
}
Memory Store (Legacy)
Get Memory Details
Retrieve detailed information about a specific memory store and its users.
GET
/
v1
/
memory
/
{memory_id}
Get Memory Details
curl --request GET \
--url https://api.bland.ai/v1/memory/{memory_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/memory/{memory_id}"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/memory/{memory_id}', 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}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/memory/{memory_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bland.ai/v1/memory/{memory_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/memory/{memory_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"data": {
"memory_id": "12345678-1234-1234-1234-123456789012",
"name": "Customer Support",
"created_at": "2025-07-20T23:32:19.840Z",
"users": [
{
"phone_number": "+12345678900",
"created_at": "2025-07-21T07:09:04.372Z",
"call_count": 0,
"metadata": "25 year old customer from New York",
"last_call_at": null,
"summary": "Previous call discussion was on the topic of startups"
}
]
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "MEMORY_NOT_FOUND",
"message": "Memory not found."
}
]
}
{
"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 to retrieve.
Response
object
Detailed memory data organized by users.
string
Unique identifier for the memory.
string
Name of the memory.
string
ISO timestamp when the memory was created.
array
Array of user objects with their associated data.
string
The phone number associated with this memory entry.
string
ISO timestamp when this user was added to the memory.
number
Total number of calls with this phone number.
string
Custom metadata text associated with this phone number.
string|null
ISO timestamp of the most recent call with this phone number, or null if no calls yet.
string
AI-generated summary of interactions with this phone number.
{
"data": {
"memory_id": "12345678-1234-1234-1234-123456789012",
"name": "Customer Support",
"created_at": "2025-07-20T23:32:19.840Z",
"users": [
{
"phone_number": "+12345678900",
"created_at": "2025-07-21T07:09:04.372Z",
"call_count": 0,
"metadata": "25 year old customer from New York",
"last_call_at": null,
"summary": "Previous call discussion was on the topic of startups"
}
]
},
"errors": null
}
Error Responses
{
"data": null,
"errors": [
{
"error": "MEMORY_NOT_FOUND",
"message": "Memory not found."
}
]
}
{
"data": null,
"errors": [
{
"error": "MEMORY_ERROR",
"message": "Failed to retrieve memory data."
}
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I