List memory stores

GET /api/v1/cloud/memory_stores Returns the Memory Stores under the current account. Archived stores are excluded by default.

Headers

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

Query parameters

Parameter	Type	Required	Description
`limit`	integer	No	Maximum number of records per page. Defaults to 20; valid range: 1–100. Values above 100 return `400 invalid_request_error`
`page`	string	No	Opaque cursor returned in `next_page` by the previous response. Mutually exclusive with `after_id` and `before_id`
`after_id`	string	No	Cursor pagination: return records after this ID. Cannot be used with `before_id`
`before_id`	string	No	Cursor pagination: return records before this ID. Cannot be used with `after_id`
`include_archived`	boolean	No	When `true`, include archived Memory Stores
`name`	string	No	Case-insensitive prefix search on the store name
`created_at[gte]`	string	No	Return only records created at or after this RFC 3339 timestamp
`created_at[lte]`	string	No	Return only records created at or before this RFC 3339 timestamp

For the complete pagination rules, see Pagination.

Example request

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

# Pagination
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/memory_stores?limit=10&after_id=memstore_xxx" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

# Search by name and include archived stores
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/memory_stores?name=docs&include_archived=true" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

HTTP 200 OK

{
  "data": [
    {
      "id": "memstore_019e3bb8d50674d9b082b73709c29c87",
      "created_at": "2026-05-18T15:33:49.449Z",
      "name": "doc-test-store",
      "type": "memory_store",
      "updated_at": "2026-05-18T15:33:49.449Z",
      "archived_at": null,
      "description": "Test store",
      "metadata": {},
      "status": "active",
      "entry_count": 0,
      "total_size": 0
    }
  ],
  "has_more": false,
  "first_id": "memstore_019e3bb8d50674d9b082b73709c29c87",
  "last_id": "memstore_019e3bb8d50674d9b082b73709c29c87",
  "next_page": null
}

Response fields

Field	Type	Description
`data`	array	Array of Memory Store objects
`has_more`	boolean	Whether more records are available
`first_id`	string \| null	ID of the first record on the current page; `null` when `data` is empty
`last_id`	string \| null	ID of the last record on the current page; `null` when `data` is empty
`next_page`	string \| null	Opaque cursor for the next page; `null` when no more records are available

Pagination

Memory Stores are returned in descending resource-ID order. To iterate through the list:

Set limit in the first request to retrieve the first page.
If has_more is true, pass next_page as the page parameter in the next request.
You can alternatively use after_id=<last_id> or before_id=<first_id> for ID-based pagination.

Error codes

HTTP	type	Trigger
400	`invalid_request_error`	Invalid `limit`, invalid timestamp format, or both `before_id` and `after_id` are specified
401	`authentication_error`	Missing or invalid authentication token

For the complete error envelope, see Errors.

​Headers

​Query parameters

​Example request

​Example response

​Response fields

​Pagination