> ## Documentation Index > Fetch the complete documentation index at: https://docs.mem.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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`. ## OpenAPI ````yaml GET /v2/collections openapi: 3.1.0 info: title: Mem API description: An API that allows you to interact with the Mem platform. version: 1.0.0 servers: - url: https://api.mem.ai security: - bearerAuth: [] paths: /v2/collections: get: tags: - external - external-v2 summary: List Collections description: >- 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`. operationId: app_src_api_routes_external_v2_collections_views_list_collections parameters: - in: query name: limit schema: anyOf: - maximum: 100 minimum: 1 type: integer - type: 'null' default: 50 description: |- Maximum number of collections in this page. Use smaller values for lower latency. Default is 50; valid range is 1 to 100. title: Limit required: false description: |- Maximum number of collections in this page. Use smaller values for lower latency. Default is 50; valid range is 1 to 100. - in: query name: page schema: anyOf: - type: string - type: 'null' description: |- Opaque cursor from a previous list response. Omit for the first page. IMPORTANT: Reuse with the same filters and `order_by` settings. title: Page required: false description: |- Opaque cursor from a previous list response. Omit for the first page. IMPORTANT: Reuse with the same filters and `order_by` settings. - in: query name: order_by schema: allOf: - enum: - created_at - updated_at title: CollectionListOrderBy type: string default: updated_at description: |- Sort key for pagination boundaries. Use `updated_at` (default) for recency feeds. Use `created_at` for creation-order views. required: false description: |- Sort key for pagination boundaries. Use `updated_at` (default) for recency feeds. Use `created_at` for creation-order views. - in: query name: filter_by_created_after schema: anyOf: - type: string format: date-time - type: 'null' description: >- Optional inclusive lower bound for collection creation time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. title: Filter By Created After required: false description: >- Optional inclusive lower bound for collection creation time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. - in: query name: filter_by_created_before schema: anyOf: - type: string format: date-time - type: 'null' description: >- Optional inclusive upper bound for collection creation time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. title: Filter By Created Before required: false description: >- Optional inclusive upper bound for collection creation time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. - in: query name: filter_by_updated_after schema: anyOf: - type: string format: date-time - type: 'null' description: >- Optional inclusive lower bound for collection update time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. title: Filter By Updated After required: false description: >- Optional inclusive lower bound for collection update time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. - in: query name: filter_by_updated_before schema: anyOf: - type: string format: date-time - type: 'null' description: >- Optional inclusive upper bound for collection update time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. title: Filter By Updated Before required: false description: >- Optional inclusive upper bound for collection update time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CollectionListResponseSchema' x-codeSamples: - lang: bash label: cURL source: |- curl "https://api.mem.ai/v2/collections?limit=20" \ --header "Authorization: Bearer $MEM_API_KEY" components: schemas: CollectionListResponseSchema: example: 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 note_count: 12 title: Project Phoenix updated_at: '2025-05-04T14:20:11Z' total: 24 properties: request_id: description: Identifier for this API request. Useful for tracing and support. title: Request Id type: string results: description: Page of collection results matching the requested sort. items: $ref: '#/components/schemas/CollectionListItemResponseSchema' title: Results type: array total: description: Total number of matching collections before pagination is applied. title: Total type: integer next_page: anyOf: - type: string - type: 'null' description: |- Opaque cursor for the next page of collection results. `null` when there are no more results. title: Next Page required: - request_id - results - total title: CollectionListResponseSchema type: object CollectionListItemResponseSchema: properties: id: description: UUID of the collection. format: uuid title: Id type: string title: description: Current title of the collection. title: Title type: string description: anyOf: - type: string - type: 'null' description: Optional description text currently stored on the collection. title: Description note_count: description: Current number of notes in the collection. title: Note Count type: integer created_at: description: Creation timestamp for the collection in ISO 8601 format. format: date-time title: Created At type: string updated_at: description: Last modification timestamp for the collection in ISO 8601 format. format: date-time title: Updated At type: string required: - id - title - description - note_count - created_at - updated_at title: CollectionListItemResponseSchema type: object securitySchemes: bearerAuth: type: http scheme: bearer ````