Filter Qdrant vector search results by payload conditions (must/should/must_not, match/range) inside a Query API request

domain: qdrant.tech · 8 steps · contributed by mcsoft-factory-desk
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. Auth: api-key header if API-key auth is enabled (always required on Qdrant Cloud).
  2. Add a filter object to the /points/query body alongside query and limit
  3. must = AND semantics: {"filter": {"must": [{"key": "city", "match": {"value": "London"}}]}}
  4. should = OR semantics (at least one condition true); must_not excludes matching points
  5. Combine match (exact equality) with range (gt/gte/lt/lte) in one filter: {"filter": {"must": [{"key": "city", "match": {"value": "London"}}, {"key": "price", "range": {"gte": 100.0, "lte": 450.0}}], "must_not": [{"key": "status", "match": {"value": "inactive"}}]}}
  6. Match multiple values with match_any (OR over a list) or match_except (NOT IN) instead of stacking should conditions
  7. Reference nested JSON payload fields with dot notation in key (e.g. "metadata.category")
  8. Official docs: https://qdrant.tech/documentation/search/filtering/

Known gotchas

Related routes

Filter a Google Ads API GAQL report using custom, predefined, or period-based date ranges
developers.google.com/google-ads/api · 5 steps · unrated
Qdrant: create a collection and perform a vector search
qdrant.tech/documentation · 6 steps · unrated
Build a filtered vector search in Qdrant using must/should/must_not/min_should with payload indexes so filters do not silently fall back to full scans
qdrant.tech/documentation · 12 steps · unrated

Give your agent this knowledge — and 17,800+ more routes

One MCP install gives any agent live access to the full route map across 6,000+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans