STU3 Candidate

This page is part of the FHIR Specification (v1.8.0: STU 3 Draft). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

2.32.15 Resource List - Operations

This resource has 1 operation associated with it:

$findFind a functional list

For more information about operations, including how they are invoked, see Operations.

2.32.15.1 Find a functional list

This operation allows a client to find an identified list for a particular function by its function. The operation takes two parameters, the identity of a patient, and the name of a functional list. The list of defined functional lists can be found at Current Resource Lists. Applications are not required to support all the lists, and may define additional lists of their own. If the system is able to locate a list that serves the identified purpose, it returns it as the body of the response with a 200 OK status. If the resource cannot be located, the server returns a 404 not found (optionally with an OperationOutcome resource)

Formal Definition (as a OperationDefinition).

URL: [base]/List/$find

In Parameters:
NameCardinalityTypeBindingProfileDocumentation
patient1..1id

The id of a patient resource located on the server on which this operation is executed

name1..1code

The code for the functional list that is being found

Note that servers may support searching by a functional list, and not support this operation that allows clients to find the list directly

2.32.15.1.1 Examples

Find the current allergy list for patient 'example' (Request):


GET /ehr/fhir/List/$find?patient=example&name=$current-allergies

Return the currnet allergies list for the patient (Response):


HTTP/1.1 200 OK
[other headers]

<?xml version="1.0" encoding="UTF-8"?>
<List xmlns="http://hl7.org/fhir">
  <id value="current-allergies"/>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml">
      <p>Patient Peter Chalmers, DOB = Dec 25, 1974, MRN = 12345 (Acme Healthcare) has the following allergies</p>
      <ul>
        <li>cashew nut allergenic extract Injectable Product (<b>High</b>)</li>
        <li>Allergenic extract, penicillin (high)</li>
      </ul>
    </div>
  </text>
  <status value="current"/>
  <mode value="working"/>
  <title value="Current Allergy List"/>
  <code>
    <coding>
      <system value="http://loinc.org"/>
      <code value="52472-8"/>
      <display value="Allergies and Adverse Drug Reactions"/>
    </coding>
    <text value="Current Allergy List"/>
  </code>
  <date value="2015-07-14T23:10:23+11:00"/>
  <source>
    <reference value="Patient/example"/>
  </source>
  <orderedBy>
    <coding>
      <system value="http://hl7.org/fhir/list-order"/>
      <code value="entry-date"/>
    </coding>
  </orderedBy>
  <entry>
    <item> 
      <reference value="AllergyIntolerance/example"/>
    </item>
  </entry>  
  <entry>
    <item> 
      <reference value="AllergyIntolerance/medication"/>
    </item>
  </entry>  
</List>