Skip to content

ServiceRequestReferralStatus Search parameter

Canonicalhttps://fhir.apps.health/SearchParameter/servicerequest-referral-status
Statusdraft · 1.33.0
QueryServiceRequest?referral-status=[value]
Parameter namereferral-status
Applies toServiceRequest
Typetoken
ExpressionServiceRequest.where(intent = 'proposal').status
SourceFSH · JSON

Filter ServiceRequest by status, counting only referrals (intent = proposal).

GET [base]/ServiceRequest?referral-status=active
GET [base]/Patient?_has:ServiceRequest:subject:referral-status=active&_sort=name

R4 cannot ask this with base parameters, and that is why this one exists. Referrals and orders share ServiceRequest and differ by intent, so "a referral in progress" is two conditions on one request. Two reverse-chained parameters (_has:ServiceRequest:subject:intent=proposal and _has:ServiceRequest:subject:status=active) are evaluated independently, and each may be satisfied by a different request: a patient with a completed referral and an active lab order matches both. This parameter indexes status on referrals only, so one _has carries both conditions and an order can never satisfy it.

It is a token over the request-status code. Any status may be asked for, and several at once (referral-status=active,on-hold); which states count as "in progress" is the caller's choice, not the definition's.

A store that has not been given this definition does not refuse a search that names it. It drops the parameter and answers as if it were absent, so an unfiltered result is indistinguishable from a successful narrow one. Load the definition before relying on it, and prove the filter ran with a negative case: a patient whose only open request is an order must be ABSENT from an active-referral search.

Indexing is separate from definition. On stores that index search parameters as a background job, writing the definition makes the parameter known and does not by itself make it usable; until the index completes, the search behaves as it does on a store that never had the definition at all.