Copy

Lists Memory entries in a Memory Store, with path-prefix filtering and cursor pagination. The list response does not include content. Use Get a Memory to retrieve content.

Path

GET /api/v1/forward/memory_stores/{memory_store_id}/memories

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT or admin SAT>`

Path parameters

Parameter	Type	Required	Description
`memory_store_id`	string	Yes	Memory Store ID (`memstore_...`).

Query parameters

Parameter	Type	Required	Description
`limit`	integer	No	Maximum number of results per page, from 1 to 100. Default: 20.
`before_id`	string	No	Backward pagination cursor. Mutually exclusive with `after_id`.
`after_id`	string	No	Forward pagination cursor. Mutually exclusive with `before_id`.
`path_prefix`	string	No	Filters by a `path` prefix. This is a plain string-prefix match, not directory semantics. For example, `path_prefix=a/b` also matches `a/bc.md`.

Example requests

# Basic list
curl -X GET "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/memories" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

# Filter by path prefix
curl -X GET "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/memories?path_prefix=decisions/" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

HTTP 200 OK

{
  "data": [
    {
      "id": "mem_00mc7mvag5u68kkfvxhy",
      "type": "memory",
      "memory_store_id": "memstore_00mc7mukn7lkxr454tjd",
      "path": "decisions/arch-choice.md",
      "content_size_bytes": 99,
      "content_sha256": "1712de0d497a5aeef2beeccf4fbb7d5a16944975438d0c25447b9c1fba13099a",
      "metadata": {"owner": "backend-team"},
      "created_at": "2026-08-14T10:00:00Z",
      "updated_at": "2026-08-14T10:00:00Z"
    }
  ],
  "first_id": "mem_00mc7mvag5u68kkfvxhy",
  "last_id": "mem_00mc7mvag5u68kkfvxhy",
  "has_more": false
}

Empty-list response

{
  "data": [],
  "first_id": null,
  "last_id": null,
  "has_more": false
}

Response fields

Field	Type	Description
`data`	array	Array of Memory objects, without `content`.
`first_id`	string/null	ID of the first record on the current page.
`last_id`	string/null	ID of the last record on the current page.
`has_more`	boolean	Whether more records are available.

Errors

HTTP	Type	Trigger
400	`invalid_request_error`	`limit` is out of range, or `after_id` and `before_id` are both supplied.
401	`authentication_error`	The authentication token is missing or invalid.
403	`permission_error`	The caller cannot access the resource.
404	`not_found_error`	The Memory Store does not exist or is not visible across users.
500/502/503	`api_error`	Forward or a dependent service failed.

​Path

​Headers

​Path parameters

​Query parameters

​Example requests

​Example response

​Empty-list response

​Response fields

​Errors