Skip to main content
GET
List memories

Authorizations

X-API-Key
string
header
required

API key created from the MemContext dashboard. Keys are prefixed with mc_, bound to one workspace, and API-key requests cannot override that workspace.

Query Parameters

limit
integer
default:20

Number of memories to return.

Required range: 1 <= x <= 100
offset
integer
default:0

Pagination offset.

Required range: x >= 0
category
string

Comma-separated category filter. Values: preference, fact, decision, context.

scope
string

Hard isolation boundary. When provided, results come only from that scope. Omit to list only unscoped/global memories.

Maximum string length: 200
project
string

Comma-separated project filter within the selected scope. Use __memcontext_no_project__ for memories without a project.

Text search across memory content (case-insensitive substring match).

Maximum string length: 200

Response

200 - application/json

Paginated memory list.

memories
object[]
required
total
integer
required

Total number of memories matching the filters.

hasMore
boolean
required

Whether more results exist beyond the current page.