Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/dhanyasukumaran1/fhir_query_validator/llms.txt

Use this file to discover all available pages before exploring further.

FHIR Query Validator validates queries against a built-in registry of HL7 FHIR R4 resource types and their defined search parameters. This page lists all supported resources and their key search parameters. Use the supported_resources list and supported_search_parameters dict to inspect the registry at runtime.

Check supported resources at runtime

from fhir_query_validator import FHIRQueryValidator

validator = FHIRQueryValidator()

# List all supported resource types
print(validator.supported_resources)
# ['Account', 'AllergyIntolerance', 'Appointment', ..., 'ValueSet']

# Get search parameters for a specific resource
patient_params = validator.supported_search_parameters["Patient"]
print(patient_params)
# ['_id', '_lastUpdated', 'active', 'address', 'birthdate', 'death-date', 'deceased',
#  'email', 'family', 'gender', 'given', 'identifier', 'language', 'link', 'name',
#  'organization', 'phone', 'phonetic', 'telecom']

Clinical resources

ResourceKey search parameters
Patientfamily, given, name, birthdate, gender, identifier, address, email, phone, deceased
Observationcode, patient, subject, category, date, status, value-quantity, component-code
Conditionpatient, subject, code, clinical-status, onset-date, recorded-date, severity, category
Procedurepatient, subject, code, status, date, performer, reason-code
DiagnosticReportpatient, subject, code, category, date, status, issued, performer
AllergyIntolerancepatient, code, clinical-status, criticality, date, type, category
Immunizationpatient, date, status, vaccine-code, target-disease, lot-number
CarePlanpatient, subject, status, category, date, activity-code, care-team
Goalpatient, subject, lifecycle-status, start-date, target-date, achievement-status
FamilyMemberHistorypatient, code, date, status, relationship, sex

Administrative resources

ResourceKey search parameters
Encounterpatient, subject, status, class, date, type, practitioner, location, reason-code
Appointmentpatient, practitioner, location, status, date, service-type, specialty
Organizationname, identifier, type, address, partof, active, endpoint
Practitionername, family, given, identifier, gender, address, communication
PractitionerRolepractitioner, organization, role, specialty, location, active
Locationname, address, type, status, organization, partof
Coveragepatient, subscriber, beneficiary, status, payor, identifier, type
Claimpatient, status, use, created, provider, insurer, identifier

Medication resources

ResourceKey search parameters
MedicationRequestpatient, subject, medication, status, intent, authoredon, requester, code
MedicationStatementpatient, subject, medication, status, effective, source, code
Medicationcode, identifier, ingredient, manufacturer, status, form
MedicationDispensepatient, subject, medication, status, whenhandedover, performer, prescription
MedicationAdministrationpatient, subject, medication, status, effective-time, performer, request

Diagnostic resources

ResourceKey search parameters
ImagingStudypatient, subject, started, status, modality, series, identifier, reason
Specimenpatient, subject, type, collected, status, identifier, accession
Mediapatient, subject, type, modality, created, status, operator
ServiceRequestpatient, subject, code, status, intent, authored, performer, category

Infrastructure resources

ResourceKey search parameters
Bundleidentifier, type, timestamp, composition
CapabilityStatementname, title, status, version, date, url, fhirversion
OperationOutcome(no standard search parameters — typically returned in responses, not queried)
ValueSetname, title, url, status, version, identifier, code, reference
CodeSystemname, title, url, status, version, identifier, code, system
StructureDefinitionname, title, url, status, type, kind, version, base
This table lists key search parameters for each resource. The full set of supported parameters — including all FHIR-defined search parameters — is available at runtime via supported_search_parameters["ResourceName"].

Universal search parameters

These parameters are supported on every resource type:
ParameterTypeDescription
_idtokenFilter by resource ID
_lastUpdateddateFilter by last modification date
_tagtokenFilter by resource tag
_profileURIFilter by profile URL
_securitytokenFilter by security label
_textstringFull-text search on narrative
_contentstringFull-text search on resource content
_filterspecialAdvanced filter expression
_countnumberLimit number of results per page
_sortstringSort results by parameter name
_includespecialInclude referenced resources in results
_revincludespecialInclude resources that reference this resource
_summarytokenReturn summary representation
_elementsstringReturn only specified elements
_formattokenResponse format (json, xml)

Build docs developers (and LLMs) love