List Collections

List collections visible to the authenticated caller with cursor pagination. Results are ordered by order_by and return next_page when additional rows are available. For relevance-ranked retrieval by query, use POST /v2/collections/search.

GET /v2/collections

cURL

cURL

curl "https://api.mem.ai/v2/collections?limit=20" \
     --header "Authorization: Bearer $MEM_API_KEY"

200

{
  "next_page": "eyJvcmRlcl9ieSI6InVwZGF0ZWRfYXQiLCJ2YWx1ZSI6IjIwMjUtMDUtMDRUMTQ6MjA6MTFaIiwiaWQiOiIwMThmOGQwZC01YTNjLTdhZmMtODMyMS0yZjZmNmUwZmVmYWIifQ",
  "request_id": "api-request-018f8d0d-5a3c-7afc-8321-2f6f6e0fefab",
  "results": [
    {
      "created_at": "2025-05-01T10:05:45Z",
      "description": "Initiatives and plans for Q1",
      "id": "018f8d0d-5a3c-7afc-8321-2f6f6e0fefab",
      "title": "Project Phoenix",
      "updated_at": "2025-05-04T14:20:11Z"
    }
  ],
  "total": 24
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit · integer | null · default: 50

Maximum number of collections in this page. Use smaller values for lower latency. Default is 50; valid range is 1 to 100.

Required range: 1 <= x <= 100

page · string | null

Opaque cursor from a previous list response. Omit for the first page. IMPORTANT: Reuse with the same order_by value.

order_by · enum<string> · default: updated_at

Sort key for pagination boundaries. Use updated_at (default) for recency feeds. Use created_at for creation-order views.

Available options: created_at, updated_at

Response

200 - application/json

OK

request_id · string · required

Identifier for this API request. Useful for tracing and support.

results · CollectionListItemResponseSchema · object[] · required

Page of collection results matching the requested sort.

Show child attributes

total · integer · required

Total number of matching collections before pagination is applied.

next_page · string | null

Opaque cursor for the next page of collection results. null when there are no more results.