Building on the Platform
...
Solutions
Access to Clinical Data
Retrieve Condition
4min
access a patient's diagnoses, clinical concerns, and conditions from their ehr this data paints a holistic health picture, vital for care coordination and providing context for ongoing treatments to access this clinical data you'll need the patient identifier, obtainable through the retrieve patient docid 8opknnbmtaz47rk5hkdd3 interaction interaction retrieving the list of conditions can be done by sending a get request the request is sent to the condition endpoint https //api \<region> founda com/1/organizations/\<org x>/fhir/4/condition?\<parameters> where \<region> should be defined according to the different founda sandbox testing docid\ ncff15xnu1wglst2wnm p and \<org x> should be replaced with the healthcare provider's organization id that you are integrated with the response contains a bundle with 0, 1 or n matching conditions the full condition resource can be retrieved with the identifier of the selected condition from the result set profile founda adheres to recognized standards (ihe, hl7 fhir) to ensure compatibility and harmonization among diverse systems if there is a profile available for an interaction, it is recommended and preferred to follow the prescribed transactions the retrieve condition interaction with the founda platform is based on the ihe qedm profile to indicate that the request and response should comply with pcc 44, the profile parameter should be included to the search set /condition? profile=https //profiles ihe net/iti/qedm parameters in order to comply with the pcc 44 transaction, the interaction should at least support the parameter in the table below additional search parameters, as defined in the fhir condition resource, can be used as well parameter type required description patient reference the patient to retrieve the condition overview for patient + category reference + token the patient to retrieve the condition overview for + the category name of the resource patient + clinical status reference + token the patient to retrieve the condition overview for + the clinical status (which can be active, resolved, or inactive) at least one of the combinations has to be supported example api call curl location 'https //api eu founda com/1/health/organizations/org 4c5739ba994d4ce9b5255d3f84a2d367/fhir/4/condition?patient=2078& profile=https%3a%2f%2fprofiles ihe net%2fiti%2fqedm%2f' \\ \ header 'authorization bearer ory at t sx5ceqgi37wtaptekgav9ggsg4uczrzoc4xe29sto jfqrulkteevvwumpd6djkd2lawdh5vrmfif0pkpnqsu' \\ \ data ''{ "resourcetype" "bundle", "id" "2d5443ae 0ccd 4ca2 88e3 297912df9954", "meta" { "lastupdated" "2023 10 17t09 13 21 500+00 00" }, "type" "searchset", "total" 1, "link" \[ { "relation" "self", "url" "https //api eu founda com/1/health/organizations/org 4c5739ba994d4ce9b5255d3f84a2d367/fhir/4/condition?patient=2078& profile=https //profiles ihe net/iti/qedm/" } ], "entry" \[ { "fullurl" "https //api eu founda com/1/health/organizations/org 4c5739ba994d4ce9b5255d3f84a2d367/fhir/4/condition/2136", "resource" { "resourcetype" "condition", "id" "2136", "meta" { "versionid" "1", "lastupdated" "2023 10 05t14 29 18 317+00 00", "source" "#upwpqhenhvh4ohnv", "tag" \[ { "system" "http //terminology hl7 org/codesystem/v3 actreason", "code" "htest", "display" "test health data" } ] }, "text" { "status" "generated", "div" "\<div xmlns=\\"http //www w3 org/1999/xhtml\\">severe burn of left ear (date 24 may 2012)\</div>" }, "clinicalstatus" { "coding" \[ { "system" "http //terminology hl7 org/codesystem/condition clinical", "code" "active" } ] }, "verificationstatus" { "coding" \[ { "system" "http //terminology hl7 org/codesystem/condition ver status", "code" "confirmed" } ] }, "category" \[ { "coding" \[ { "system" "http //terminology hl7 org/codesystem/condition category", "code" "encounter diagnosis", "display" "encounter diagnosis" }, { "system" "http //snomed info/sct", "code" "439401001", "display" "diagnosis" } ] } ], "severity" { "coding" \[ { "system" "http //snomed info/sct", "code" "24484000", "display" "severe" } ] }, "code" { "coding" \[ { "system" "http //snomed info/sct", "code" "39065001", "display" "burn of ear" } ], "text" "burnt ear" }, "bodysite" \[ { "coding" \[ { "system" "http //snomed info/sct", "code" "49521004", "display" "left external ear structure" } ], "text" "left ear" } ], "subject" { "reference" "patient/2078" }, "onsetdatetime" "2012 05 24" }, "search" { "mode" "match" } } ] }