Search Subscriptions Route
GET/v1/subscriptions/search
Two-stage search (exact case-insensitive, then trigram fuzzy).
Returns :class:SubscriptionSearchResponse - an envelope carrying
items, total (len(items) by construction since the
search route caps at limit and never paginates), and query
(the q param echoed back). The envelope shape matches the
codebase-wide convention for list-shape responses; returning a
bare JSON array here would make this the only list endpoint that
doesn't wrap.
The min_length=1 on the q query param allows the service
layer's :class:SearchQueryTooShort (min 2 chars post-strip) to
fire - the 1-char FastAPI floor rejects the empty string at
the edge; the tighter 2-char service floor rejects single-char
queries that slipped past min_length=1.
Request
Responses
- 200
- 422
Successful Response
Validation Error