Actions performed on a patient
Retrieving a patient’s procedures
The logical ID (of the patient to retrieve) is passed as part of the URL. The logical ID is found as the result of a search.
GET https://tw171.open.allscripts.com/FHIR/Patient/id/Procedure GET https://tw171.open.allscripts.com/FHIR/Patient/id/Procedure?date=eq2016-01-01
|id||yes||URL||Patient’s logical ID. This is retrieved using the search function.|
|date||no||string||A string representing a date to include in the search. See below for more information.|
A DAF Procedure is returned.
|identifier||0..*||Procedure identifier. These identifiers are defined by business processes and/or used to refer to it when a direct URL reference to the resource itself is not appropriate (for example, in CDA documents, or in written/printed documentation).|
|subject||Reference(Patient, Group)||1..1||Person, animal, or group on which the procedure was performed.|
|status||code||1..1||In-progress, aborted, completed, or entered-in-error. For more information on this value set, see procedure-status.|
|category||CodeableConcept||0..1||Classification of the procedure. For more information on this value set, see procedure-category.|
|code||CodeableConcept||1..1||Identification code of the procedure. The value set defines a set of codes that can be used to indicate the type of procedure: a specific code indicating type of procedure performed from CPT, SNOMED CT, and ICD10-PCS. For more information on this value set, see procedure-code.|
|notPerformed||boolean||0..1||Was the procedure not performed as scheduled? (Yes if not scheduled.)|
|reasonNotPerformed||CodeableConcept||0..*||Reason procedure was not performed. For more information on this value set, see procedure-not-performed-reason.|
|bodySite||CodeableConcept||0..*||Target body sites. For more information on this value set, see body-site.|
|reasonCodeableConcept||CodeableConcept||0..1||Reason why the procedure was performed.|
|reasonReference||Reference(Condition)||0..1||Reason for the procedure.|
|performer||0..*||Individual who performed the procedure. This must be a real person, not equipment.|
|– performer.actor||Reference(Practitioner, Organization, Patient, RelatedPerson)||0..1||Reference to the practitioner.|
|– performer.role||CodeableConcept||0..1||Role the actor was in. Values come from performer-role.|
|performedDateTime||dateTime||0..1||Date/time period over which the procedure was performed. Allows a period to support complex procedures that span more than one date, and also allows for the length of the procedure to be captured.|
|performedPeriod||Period||0..1||Date/time period during which the procedure was performed.|
|encounter||Reference(Encounter)||0..1||Encounter during which the procedure was performed.|
|location||Reference(Location)||0..1||Location where the procedure was performed.|
|outcome||CodeableConcept||0..1||Result of the procedure. For more information on this value set, see procedure-outcome.|
|report||Reference(DiagnosticReport)||0..*||Any report resulting from the procedure.|
|complication||CodeableConcept||0..*||Complication following the procedure. For more information on this value set, see condition-code.|
|followUp||CodeableConcept||0..*||Instructions for follow up. For more information on this value set, see procedure-followup.|
|request||Reference(CarePlan, DiagnosticOrder, ProcedureRequest, ReferralRequest)||0..1||Request for the procedure.|
|notes||Annotation||0..*||Additional information about the procedure.|
|focalDevice||0..*||Device changed during the procedure.|
|– focalDevice.action||CodeableConcept||0..1||Kind of change to device. For more information on this value set, see device-action.|
|– focalDevice.manipulated||Reference(Device)||1..1||Device that was changed during the procedure.|
|used||Reference(Device, Medication, Substance)||0..*||Items used during the procedure.|
Searching by date
Dates are passed as query parameters on the URL. Since the URL parameters cannot handle comparators (for example, >, <=) these are passed in as part of the date.
The following comparators are supported:
|ge||greater than or equal|
|le||less than or equal|
To search for a date range, pass in the date twice.
This search would include every day in the year 2010.