You can use this action if you want to access a patient’s diagnoses—as documented by a specific organization. The EHR system returns a patient’s general diagnoses, problems, or health concerns. Typically, you can use this for offering:
To use this API action, you must know the patient identifier. If you don’t, you must locate the appropriate identifier first. Learn how to search for a patient with demographics.
You can use this API action with the Redox FHIR® API.
It’s also possible to use the Redox Data Model API for this API action. Talk to a Redoxer to learn about your options if you want to use alternative integration methods.
Your connection's system can return results with their own FHIR® or query-based API.
You can only search and receive data from one organization for one patient. If you want a comprehensive list for a patient from multiple organizations, you must perform this API action for every organization you’re interested in receiving data from.
Diagnoses are specific to patient encounters. The diagnosed condition is usually provided in International Classification of Diseases (ICD-10) codes.
Patient problems may come from patient encounters or health concerns reported by the patient outside of a visit. Problems are typically provided in SNOMED codes and can potentially span several encounters. Any reported health concerns are not specific to a codeset and can be anything defined by the EHR system.
It’s possible that you may get a list of patient diagnoses that's missing the onset period, recorded date, or verification status. These fields aren’t required in the response, so it may be difficult to understand where the patient is at in their patient journey. For example, you may not know how recently the patient was diagnosed, whether a treatment plan has been made or accepted, whether any treatment has already been performed, or whether the patient has completed treatment already.
Does this API action seem like a good fit for your unique workflow? If so, let your Redox rep know! You can begin development by downloading the relevant resource schema (which is noted in the relevant action step below), and deciding which data elements you need. Then head over to our Quickstart guide to dive right in.
If you're not engaged with our sales team yet, talk to a Redoxer to get started.
The following actions must be completed before attempting the steps below.
This table has notes about how to use parameters for this API action specifically, but it's not exhaustive. Refer to the resource schema for more details.
Query parameter | Required | Notes |
|---|---|---|
patient.identifier | Y | You must include at least one identifier for the patient that's used by the EHR system you're querying. If you don't have a patient identifier, you can find one by searching for a patient with demographics. |
category | N | We recommend using this query parameter with the value problem-list-item to get a comprehensive list of diagnoses. |
The response contains one or more conditions for an individual patient. You can find the total number of included diagnoses in the total array for FHIR® responses.
curl ---location --request POST 'https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Condition/_search' \--header 'Content-Type: application/x-www-form-urlencoded' \--header 'Authorization: Bearer ${API_TOKEN}' \--data-urlencode 'patient=Patient/81c2f5eb-f99f-40c4-b504-59483e6148d7' \--data-urlencode 'category=problem-list-item'
{"id": "c336094f-e294-4d9e-baee-89e26f6ac648","type": "searchset","entry": [{"search": {"mode": "match","score": 1},"resource": {"id": "fc26ffe0-130f-41a6-bd22-2cd388eb3ddf","code": {"coding": [{"code": "386661006","system": "http://snomed.info/sct","display": "Fever"}]},"meta": {"lastUpdated": "2022-12-02T20:50:05.204Z"},"subject": {"reference": "Patient/81c2f5eb-f99f-40c4-b504-59483e6148d7"},"bodySite": [{"coding": [{"code": "38266002","system": "http://snomed.info/sct","display": "Entire body as a whole"}]}],"category": [{"coding": [{"code": "55607006","system": "http://snomed.info/sct","display": "Problem"},{"code": "problem-list-item","system": "http://terminology.hl7.org/CodeSystem/condition-category"}]}],"severity": {"coding": [{"code": "255604002","system": "http://snomed.info/sct","display": "Mild"}]},"identifier": [{"value": "5849283275","system": "urn:redox:redox-fhir-sandbox:ConditionID","extension": [{"url": "https://fhir.redoxengine.com/StructureDefinition/identifier-origin","valueString": "RedoxAPI"}]}],"resourceType": "Condition","onsetDateTime": "2022-08-06T04:00:00.000Z","clinicalStatus": {"coding": [{"code": "resolved","system": "http://terminology.hl7.org/CodeSystem/condition-clinical"}]},"abatementDateTime": "2022-08-06T04:00:00.000Z","verificationStatus": {"coding": [{"code": "confirmed","system": "http://terminology.hl7.org/CodeSystem/condition-ver-status"}]}}}],"total": 1,"resourceType": "Bundle"}