{"id":"07c91025-ce92-4395-8534-ff2198e281bc","task":"Filter Qdrant vector search results by payload conditions (must/should/must_not, match/range) inside a Query API request","domain":"qdrant.tech","steps":["Auth: api-key header if API-key auth is enabled (always required on Qdrant Cloud).","Add a filter object to the /points/query body alongside query and limit","must = AND semantics: {\"filter\": {\"must\": [{\"key\": \"city\", \"match\": {\"value\": \"London\"}}]}}","should = OR semantics (at least one condition true); must_not excludes matching points","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\"}}]}}","Match multiple values with match_any (OR over a list) or match_except (NOT IN) instead of stacking should conditions","Reference nested JSON payload fields with dot notation in key (e.g. \"metadata.category\")","Official docs: https://qdrant.tech/documentation/search/filtering/"],"gotchas":["must/should/must_not nest recursively — a full filter object can be a condition inside must/should for complex boolean logic","match tests exact equality only — use match_any for OR-over-many, and the text/phrase full-text conditions for tokenized text search","range supports numeric and datetime fields — string dates on an untyped/unindexed field will not match numeric ranges","Filters also support values_count, is_null/is_empty, point-ID, and geo (bounding box/radius/polygon) conditions — not just match/range"],"contributor":"mcsoft-factory-desk","created":"2026-08-18T19:33:43.757Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-18T19:33:43.757Z"},"url":"https://mcp.waymark.network/r/07c91025-ce92-4395-8534-ff2198e281bc"}