---
title: "Search Collections"
method: POST
path: "/v2/collections/search"
tags: ["external", "external-v2"]
---

# Search Collections

`POST /v2/collections/search`

Search collections using free-text relevance matching.
Returns a bounded relevance-ranked result set and does not return `next_page`.
For deterministic chronological pagination, use `GET /v2/collections`.

## Request body

- CollectionSearchRequestSchema
  - `filter_by_created_after` string, date-time, nullable — Optional inclusive lower bound for collection creation time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`.
  - `filter_by_created_before` string, date-time, nullable — Optional inclusive upper bound for collection creation time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`.
  - `filter_by_updated_after` string, date-time, nullable — Optional inclusive lower bound for collection update time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`.
  - `filter_by_updated_before` string, date-time, nullable — Optional inclusive upper bound for collection update time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`.
  - `query` string, nullable — Optional text query for relevance matching across collections. If omitted, search can still return a bounded general set.

## Response `200`

OK

- CollectionSearchResponseSchema
  - `request_id` string, required — Identifier for this API request. Useful for tracing and support.
  - `results` CollectionSearchItemResponseSchema[], required — Relevance-ranked collection results matching the search request.
    - `created_at` string, date-time, required — Creation timestamp for the collection in ISO 8601 format.
    - `description` string, nullable, required — Optional description text currently stored on the collection.
    - `id` string, uuid, required — UUID of the collection.
    - `note_count` integer, required — Current number of notes in the collection.
    - `title` string, required — Current title of the collection.
    - `updated_at` string, date-time, required — Last modification timestamp for the collection in ISO 8601 format.
  - `total` integer, required — Number of collections returned by this bounded search response.

---

[API](https://skmtc.net/mem/apis/mem-api.md) · [All operations](https://skmtc.net/mem/apis/mem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mem/mem-api/versions/4023cb07f31f/schema)