1. Memories
  2. Get Memory Stats
GET
/assistants/{assistant_id}/memories/stats
curl --request GET \
     --url https://app.backboard.io/api/assistants/{assistant_id}/memories/stats \
     --header 'X-API-Key: <api-key>' \
     --header 'authorization: <authorization>' \
     --header 'x_session_token: <x_session_token>'

​
Overview

Returns memory usage and limits for an assistant: total count, content signals, and quota information.

Use this when you need a quick count before adding memories, or to show usage in your own UI.

​
What you get back

FieldDescription
total_memoriesHow many memories exist right now
memory_typesRough categories (personal info, preferences, professional, health) inferred from content
has_personal_infoWhether any memory looks like personal identity info
has_preferencesWhether any memory looks like user preferences
last_updatedWhen the most recently updated memory changed
limitsYour plan’s memory cap and how much is used

​
SDK

stats = await client.get_memory_stats(assistant_id)
print(stats.total_memories)

​
Authorizations

X-API-Key
required
string
API Key authentication

​
Query Parameters

assistant_id
required
string
authorization
x_session_token

​
Response

application/json
  • 200

  • 422

Successful Response