FHIR Client Integration Guide
Bundle structure
type: "collection". Each entry needs a unique fullUrl — it's how validation errors point back to the exact resource.{
"resourceType": "Bundle",
"type": "collection",
"entry": [
{
"fullUrl": "urn:uuid:2a3f9f10-5b1c-4ad3-9c1c-6f8a2a0b3e41",
"resource": { /* Patient | Observation | MedicationStatement | Condition */ }
}
]
}⚠️ Warning: A missing fullUrlmakes error reporting ambiguous and may fail validation. Generate a fresh UUID per entry.
Patient resource
{
"resourceType": "Patient",
"id": "000005",
"gender": "male",
"birthDate": "1995-08-01"
}gender: "male" or "female"birthDate: YYYY-MM-DDObservation resources
status must be "final". All fields shown are mandatory.{
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [{
"system": "http://loinc.org",
"code": "6690-2",
"display": "Leukocytes [#/volume] in Blood by Automated count"
}],
"text": "Leukocytes"
},
"subject": { "reference": "Patient/000005" },
"valueQuantity": {
"value": 6.0,
"unit": "G/L",
"system": "http://unitsofmeasure.org",
"code": "G/L"
}
}⚠️ Warning: Always send a valid ISO-8601 effectiveDateTime, and use recent values — labs within 90 days, vitals (blood pressure, height, weight) within 30 days, per the Instructions for Use.
MedicationStatement resources
http://www.cardioexplorer.ai (full code list in Cardiac Data Requirements). Status maps to presence:| FHIR status | Stored as |
|---|---|
active (with valid effectiveDateTime) | Yes — patient takes the medication |
not-taken · stopped · completed · on-hold · unknown · intended · entered-in-error | No |
| Missing / invalid status | Rejected |
ℹ️ Note: Glucose-lowering therapy is a special case — when active, specify the sub-type: CE_GLUECOSE_THERAPY_INSULINorCE_GLUECOSE_THERAPY_NON_INSULIN. With no therapy, send the base codeCE_GLUECOSE_THERAPYwith an inactive status.
💡 Tip: If you use a medication code our system doesn't recognize, contact info@explorishealth.com — we add it to the code mapping so your codes resolve automatically.
Conditions (SNOMED CT)
Condition resources with clinicalStatus: active and verificationStatus: confirmed.429559004 — Typical angina → "Typical"371807002 — Atypical angina → "Atypical"100001275 — Non-anginal chest pain → "Non-cardiac chest pain"100000932 — Asymptomatic → "No chest pain"164916001 — Normal Q wave → "No"164917005 — Abnormal Q wave → "Yes"Nicotine consumption
Observation with LOINC code 72166-2 (tobacco smoking status) and a valueCodeableConcept:LA18978-9 — Never smoked → "Non-smoker"LA15920-4 — Ex-smoker → "Ex-smoker"LA20356-4 — Current every day smoker → "Smoker"Common issues
⚠️ Warning — stale data: keep values within the IFU freshness windows (labs ≤ 90 days, vitals ≤ 30 days). Do not submit historical data just to fill a gap.
⚠️ Warning — missing fullUrl: validation may fail and error reporting becomes unclear. Include a uniquefullUrlfor every entry.
Complete example
{
"resourceType": "Bundle",
"type": "collection",
"entry": [
{
"fullUrl": "urn:uuid:2a3f9f10-5b1c-4ad3-9c1c-6f8a2a0b3e41",
"resource": {
"resourceType": "Patient",
"id": "000005",
"gender": "male",
"birthDate": "1995-08-01"
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000001",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "6690-2",
"display": "Leukocytes [#/volume] in Blood by Automated count"
}
],
"text": "Leukocytes"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 6.0,
"unit": "G/L",
"system": "http://unitsofmeasure.org",
"code": "G/L"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000002",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "6768-6",
"display": "Alkaline phosphatase [Enzymatic activity/volume] in Serum or Plasma"
}
],
"text": "Alkaline phosphatase"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 120.0,
"unit": "U/L",
"system": "http://unitsofmeasure.org",
"code": "U/L"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000003",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "30525-0",
"display": "Age"
}
],
"text": "Age"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 30,
"unit": "years",
"system": "http://unitsofmeasure.org",
"code": "a"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000004",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8302-2",
"display": "Body height"
}
],
"text": "Body height"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 181.0,
"unit": "cm",
"system": "http://unitsofmeasure.org",
"code": "cm"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000005",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "29463-7",
"display": "Body weight"
}
],
"text": "Body weight"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 95.0,
"unit": "kg",
"system": "http://unitsofmeasure.org",
"code": "kg"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000006",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8480-6",
"display": "Systolic blood pressure"
}
],
"text": "Systolic blood pressure"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 123,
"unit": "mmHg",
"system": "http://unitsofmeasure.org",
"code": "mm[Hg]"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000007",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8462-4",
"display": "Diastolic blood pressure"
}
],
"text": "Diastolic blood pressure"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 88,
"unit": "mmHg",
"system": "http://unitsofmeasure.org",
"code": "mm[Hg]"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000008",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "2093-3",
"display": "Cholesterol [Mass/volume] in Serum or Plasma"
}
],
"text": "Total cholesterol"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 4.5,
"unit": "mg/dL",
"system": "http://unitsofmeasure.org",
"code": "mg/dL"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000009",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "2085-9",
"display": "Cholesterol in HDL [Mass/volume] in Serum or Plasma"
}
],
"text": "HDL cholesterol"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 1.6000000238418579,
"unit": "mmol/L",
"system": "http://unitsofmeasure.org",
"code": "mmol/L"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000010",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "13457-7",
"display": "Cholesterol in LDL [Mass/volume] in Serum or Plasma by calculation"
}
],
"text": "LDL cholesterol"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 2.5,
"unit": "mmol/L",
"system": "http://unitsofmeasure.org",
"code": "mmol/L"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000011",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "2345-7",
"display": "Glucose [Mass/volume] in Serum or Plasma"
}
],
"text": "Glucose"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 12,
"unit": "mg/dL",
"system": "http://unitsofmeasure.org",
"code": "mg/dL"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000012",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "2885-2",
"display": "Protein [Mass/volume] in Serum or Plasma"
}
],
"text": "Total protein"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 70.0,
"unit": "g/L",
"system": "http://unitsofmeasure.org",
"code": "g/L"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000013",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "1751-7",
"display": "Albumin [Mass/volume] in Serum or Plasma"
}
],
"text": "Albumin"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 45.0,
"unit": "g/dL",
"system": "http://unitsofmeasure.org",
"code": "g/dL"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000014",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "1975-2",
"display": "Bilirubin.total [Mass/volume] in Serum or Plasma"
}
],
"text": "Total bilirubin"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 70.0,
"unit": "µmol/L",
"system": "http://unitsofmeasure.org",
"code": "umol/L"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000015",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "3094-0",
"display": "Urea nitrogen [Mass/volume] in Serum or Plasma"
}
],
"text": "Urea"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 5.0,
"unit": "mg/dL",
"system": "http://unitsofmeasure.org",
"code": "mg/dL"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000016",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "3084-1",
"display": "Urate [Mass/volume] in Serum or Plasma"
}
],
"text": "Uric acid"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 250.0,
"unit": "µmol/L",
"system": "http://unitsofmeasure.org",
"code": "umol/L"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000017",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "28540-3",
"display": "MCHC [Entitic Mass/volume] in Red Blood Cells"
}
],
"text": "MCHC"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 330.0,
"unit": "g/L",
"system": "http://unitsofmeasure.org",
"code": "g/L"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000018",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "1805-1",
"display": "Amylase.pancreatic [Enzymatic activity/volume] in Serum or Plasma"
}
],
"text": "Pancreatic amylase"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 50.0,
"unit": "U/L",
"system": "http://unitsofmeasure.org",
"code": "U/L"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000019",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "67151-1",
"display": "Troponin T.cardiac [Mass/volume] in Serum or Plasma by High sensitivity method"
}
],
"text": "High-sensitivity troponin T"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 3.0,
"unit": "ng/L",
"system": "http://unitsofmeasure.org",
"code": "ng/L"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000020",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "1742-6",
"display": "Alanine aminotransferase [Enzymatic activity/volume] in Serum or Plasma"
}
],
"text": "ALAT"
},
"subject": {
"reference": "Patient/000005"
},
"valueQuantity": {
"value": 25.0,
"unit": "U/L",
"system": "http://unitsofmeasure.org",
"code": "U/L"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000021",
"resource": {
"resourceType": "MedicationStatement",
"id": "diuretic-furosemide-1",
"status": "active",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.cardioexplorer.ai",
"code": "CE_DIURETIC_THERAPY",
"display": "Furosemide 40 mg oral tablet"
}
],
"text": "Furosemide 40 mg oral tablet"
},
"subject": {
"reference": "Patient/000005"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000022",
"resource": {
"resourceType": "MedicationStatement",
"id": "beta-blocker-product-1",
"status": "active",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.cardioexplorer.ai",
"code": "CE_BETA_BLOCKER_PLACEHOLDER",
"display": "Beta blocker (product)"
}
],
"text": "Beta blocker"
},
"subject": {
"reference": "Patient/000005"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000023",
"resource": {
"resourceType": "MedicationStatement",
"id": "cp-gtn-spray-1",
"status": "intended",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.cardioexplorer.ai",
"code": "CE_ANTI_ANGINAL_NITRATE_THERAPY",
"display": "Nitroglycerin sublingual spray"
}
],
"text": "Nitroglycerin sublingual spray"
},
"subject": {
"reference": "Patient/000005"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000024",
"resource": {
"resourceType": "MedicationStatement",
"id": "ace-ramipril-1",
"status": "active",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.cardioexplorer.ai",
"code": "CE_RAAS_INHIBITING_THERAPY",
"display": "Ramipril 5 mg oral capsule"
}
],
"text": "Ramipril 5 mg oral capsule"
},
"subject": {
"reference": "Patient/000005"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000025",
"resource": {
"resourceType": "MedicationStatement",
"id": "ccb-amlodipine-1",
"status": "active",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.cardioexplorer.ai",
"code": "CE_CALCIUM_CHANNEL_BLOCKER_THERAPY",
"display": "Amlodipine 5 mg oral tablet"
}
],
"text": "Amlodipine 5 mg oral tablet"
},
"subject": {
"reference": "Patient/000005"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000026",
"resource": {
"resourceType": "MedicationStatement",
"id": "statin-atorvastatin-1",
"status": "active",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.cardioexplorer.ai",
"code": "CE_LIPID_LOWERING_THERAPY",
"display": "Atorvastatin 20 mg oral tablet"
}
],
"text": "Atorvastatin 20 mg oral tablet"
},
"subject": {
"reference": "Patient/000005"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000027",
"resource": {
"resourceType": "MedicationStatement",
"status": "active",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.cardioexplorer.ai",
"code": "CE_GLUECOSE_THERAPY_INSULIN",
"display": "Insulin therapy"
}
],
"text": "Insulin therapy"
},
"subject": {
"reference": "Patient/000005"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000028",
"resource": {
"resourceType": "MedicationStatement",
"id": "antiplatelet-therapy-1",
"status": "not-taken",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.cardioexplorer.ai",
"code": "CE_ANTIPLATELET_THERAPY",
"display": "Clopidogrel [Presence]"
}
],
"text": "Clopidogrel"
},
"subject": {
"reference": "Patient/000005"
}
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000029",
"resource": {
"resourceType": "Condition",
"id": "chest-pain-typical-001",
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "429559004",
"display": "Typical angina (disorder)"
}
],
"text": "Typical angina"
},
"clinicalStatus": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
"code": "active",
"display": "Active"
}
]
},
"verificationStatus": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
"code": "confirmed",
"display": "Confirmed"
}
]
},
"subject": {
"reference": "Patient/000005"
},
"onsetDateTime": "2026-07-29T00:00:00Z"
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000030",
"resource": {
"resourceType": "Condition",
"clinicalStatus": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
"code": "active",
"display": "Active"
}
]
},
"verificationStatus": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
"code": "confirmed",
"display": "Confirmed"
}
]
},
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "164916001",
"display": "Normal Q wave"
}
],
"text": "Normal Q wave observed on resting ECG."
},
"subject": {
"reference": "Patient/000005"
},
"onsetDateTime": "2026-07-29T00:00:00Z",
"note": [
{
"text": "Normal Q wave observed on resting ECG."
}
]
}
},
{
"fullUrl": "urn:uuid:11111111-aaaa-4bbb-cccc-000000000031",
"resource": {
"resourceType": "Observation",
"status": "final",
"effectiveDateTime": "2026-07-29T00:00:00Z",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "72166-2",
"display": "Tobacco smoking status"
}
],
"text": "Nicotine consumption (NC)"
},
"subject": {
"reference": "Patient/000005"
},
"valueCodeableConcept": {
"coding": [
{
"system": "http://loinc.org",
"code": "LA15920-4",
"display": "Ex-smoker"
}
],
"text": "Ex-smoker"
}
}
}
]
}