FHIR Implementation Guide

Input and output FHIR shapes MedListIQ understands and produces.

A formal IG is in progress. This page documents the current shapes in prose; the IG artifacts (StructureDefinitions, examples, CapabilityStatement) will be published here when ready.

Input profiles

MedListIQ accepts standard FHIR R4 medication resources. Any mix of the following in a single request:

• MedicationRequest — orders and prescriptions. Status, intent, dosage instructions, reason codes.
• MedicationDispense — pharmacy fills. Proves the patient actually received the drug.
• MedicationStatement — patient-reported or clinician-reported medication history.
• MedicationAdministration — administration events (inpatient / infusion settings).
• Medication — referenced via medicationReference from the above. Resolved during processing.

Pass them as a flat resources array, a FHIR Bundle, or both. No Patient or subject references required — requests are single-patient-scoped by the API key’s calling context.

Output profiles (current)

Today, MedListIQ returns its own inferred_list shape — a purpose-built schema for deduplicated, status-classified medications. It’s designed for ergonomic consumption by UIs and downstream systems. See the API Reference for full schema.

Output profiles (planned)

First-class FHIR outputs are on the roadmap:

• Bundle of MedicationRequest — standard FHIR shape for ingestion into FHIR stores
• Bundle of MedicationRequest + Provenance — each inferred medication accompanied by a Provenance resource documenting sources, evidence, and enrichments
• US Core profiles — US Core MedicationRequest, US Core Medication, US Core Provenance conformance

These are surfaced today via the format request parameter with the values bundle and us_core — currently returning 501 Not Implemented while the profiles are finalized.

Code systems we produce

System	URI	Used for
RxNorm	http://www.nlm.nih.gov/research/umls/rxnorm	Medication canonicalization
SNOMED CT	http://snomed.info/sct	Routes, methods, indications
NCI Thesaurus	http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl	Routes, methods, frequency
ICD-10-CM	http://hl7.org/fhir/sid/icd-10-cm	Indications
FHIR v3 GTS abbreviation	http://terminology.hl7.org/CodeSystem/v3-GTSAbbreviation	Frequency (QD, BID, etc.)
FHIR event-timing	http://hl7.org/fhir/event-timing	Timing events (MORN, AFT, EVE)
FHIR v3 TimingEvent	http://terminology.hl7.org/CodeSystem/v3-TimingEvent	Timing events (HS, AC, PC)
UCUM	http://unitsofmeasure.org	Durations and dose quantities

See the Enrichments catalog for how we populate each of these from raw input.