Introduction to FHIR Search Parameters
FHIR (Fast Healthcare Interoperability Resources) is a standard for exchanging healthcare information electronically. One of its powerful features is the ability to query resources using SearchParameters. These parameters allow developers and systems to fetch relevant data using specific criteria, ensuring efficient and accurate data retrieval. Exploring FHIR Search Parameters with Linked Resources provides a comprehensive understanding of how interconnected healthcare data can be effectively queried and utilized.
Creating Linked FHIR Resources
Let’s construct a set of FHIR resources for a patient named John Smith, linking them to reflect relationships among resources.
1. Patient Resource
{
“resourceType”: “Patient”,
“id”: “john-smith”,
“name”: [
{
“family”: “Smith”,
“given”: [“John”]
}
],
“gender”: “male”,
“birthDate”: “1980-05-20”
}
2. AllergyIntolerance Resource
{
“resourceType”: “AllergyIntolerance”,
“id”: “allergy-john”,
“patient”: {
“reference”: “Patient/john-smith”
},
“code”: {
“text”: “Peanut Allergy”
},
“clinicalStatus”: {
“coding”: [
{
“system”: “http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical”,
“code”: “active”
}
]
}
}
3. Practitioner (Provider) Resource
{
“resourceType”: “Practitioner”,
“id”: “provider-jane-doe”,
“name”: [
{
“family”: “Doe”,
“given”: [“Jane”]
}
]
}
4. Encounter Resource
{
“resourceType”: “Encounter”,
“id”: “encounter-john”,
“subject”: {
“reference”: “Patient/john-smith”
},
“participant”: [
{
“individual”: {
“reference”: “Practitioner/provider-jane-doe”
}
}
],
“status”: “finished”,
“period”: {
“start”: “2023-12-01T09:00:00Z”,
“end”: “2023-12-01T10:00:00Z”
}
}
5. MedicationRequest Resource
{
“resourceType”: “MedicationRequest”,
“id”: “medication-john”,
“subject”: {
“reference”: “Patient/john-smith”
},
“medicationCodeableConcept”: {
“text”: “Amoxicillin”
},
“authoredOn”: “2023-12-01”,
“requester”: {
“reference”: “Practitioner/provider-jane-doe”
}
}
6. CareTeam Resource
{
“resourceType”: “CareTeam”,
“id”: “careteam-john”,
“subject”: {
“reference”: “Patient/john-smith”
},
“participant”: [
{
“role”: [
{
“text”: “Primary Care Physician”
}
],
“member”: {
“reference”: “Practitioner/provider-jane-doe”
}
}
]
}
FHIR Query Examples
Here are 10 examples of FHIR queries using various operators to demonstrate how to retrieve data efficiently:
| Scenario | FHIR Query |
| Find John Smith by family name | Patient?family=Smith |
| Find patients born after May 1, 1980 | Patient?birthdate=gt1980-05-01 |
| Find encounters for John Smith | Encounter?subject=Patient/john-smith |
| Find encounters with Jane Doe as a participant | Encounter?participant=Practitioner/provider-jane-doe |
| Search allergies for John Smith | AllergyIntolerance?patient=Patient/john-smith |
| Find active allergies | AllergyIntolerance?clinical-status=active |
| Find medication requests authored before 2023-12-02 | MedicationRequest?authoredon=lt2023-12-02 |
| Find care teams for John Smith | CareTeam?subject=Patient/john-smith |
| Search by combined conditions (family and gender) | Patient?family=Smith&gender=male |
| Exclude a specific practitioner from care teams | CareTeam?participant:not=Practitioner/provider-jane-doe |
Conclusion
FHIR SearchParameters empower developers to query healthcare data in a structured and precise way. The examples and linked resources above illustrate how interconnected healthcare data can be navigated using FHIR’s versatile querying capabilities. By mastering these parameters, developers can unlock the full potential of FHIR in building interoperable healthcare solutions.
