Every team that ships FHIR search queries eventually notices the same pattern: two developers write the same-shaped query with different conventions, and the second one costs a review round. Codifying the conventions is small work up front...
Category: Fhir Search Lint
Linter Rules to Catch the Ten Most Common Search Mistakes
A FHIR search linter is a small pile of rules that check a query string before it hits the server. The site's FHIR search query auditor implements the rules below. They are the payoff-heavy list — each catches a class of mistake that...
Sort Order That Survives Resource Updates
FHIR sort is a _sort parameter with a comma-separated list of parameter names, optionally negated with a leading dash for descending order. The mechanic looks simple. It becomes not-simple the moment two resources tie on the sort key and...
Using _count and _offset Without Losing Consistency
FHIR search pagination is a topic where the spec is careful and the servers vary. _count requests a page size, servers may cap it, offset-style pagination via _offset produces inconsistent results when the underlying set changes between...
Modifier Stacking: :not, :in, :missing Without Foot-Guns
FHIR search modifiers turn a plain parameter into a set-operation query. :not inverts, :in filters against a value set, :missing finds resources where the element is absent. Each is useful; each has edge cases; server support is uneven....
Date Search Precision and the Range It Implicitly Covers
FHIR date search has a precision-implies-range rule that trips up callers who have not read the chapter. A search for ?date=2026 matches everything in that year. A search for ?date=2026-07-11 matches everything on that day. The precision...
Reserved Characters in Search Values That Break Silently
FHIR search reserves a small set of characters for structural meaning inside a search value: comma, ampersand, pipe, dollar sign, and a couple of others. Values that carry any of them raw truncate silently at the first delimiter, and the...
The FHIR Searches That Look Correct But Are Wrong
FHIR search is permissive on the way in. The server accepts the parameters, returns a searchset Bundle, and reports no error. That combination hides a category of queries that are syntactically valid, semantically wrong, and produce...
