listHandler(_:)

func listHandler(_ req: Request) async throws -> QuartermasterListData

GET /api/v3/quartermaster

Returns a paginated list of Quartermaster items, sorted by most-recently-modified first. Items owned by blocked or muted users are excluded from results.

Query Parameters:

  • category=have|need — filter to one category
  • search=<string> — full-text search across name, description, and location
  • mine=true — return only the authenticated user’s own items

  • start=<n> / limit=<n> — pagination (max size: Settings.shared.maximumTwarrts)

Throws

400 if category is not a recognized value; 401 if unauthenticated.

Return Value

QuartermasterListData

Show on GitHub