Get an appointment by ID
get
/Appointment/{ID}
Retrieves an appointment by the associated appointment ID.
Authorization Types
This operation supports the following authorization types:
Request
Path Parameters
-
ID(required): string
The logical resource ID associated with the resource.
Header Parameters
-
Authorization(required): string
Contains the credentials to authenticate a consumer to the service. This should be the OAuth2 Bearer token.
-
accept(required): string
The media type to be requested. See what the resource's operation produces for what is supported.
Response
Supported Media Types
- application/fhir+json
Default Response
Example retrieval of an appointment.
Example Request:GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Appointment/4822366
Example Response:
{
'fullUrl': 'https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Appointment/4822366',
'resource': {
'resourceType': 'Appointment',
'id': '4822366',
'meta': {
'versionId': '2',
'lastUpdated': '2021-04-22T12:21:26Z'
},
'text': {
'status': 'generated',
'div': '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Appointment</b></p><p><b>Status</b>: Cancelled</p><p><b>Service Type</b>: Surgery Rapid</p><p><b>Start</b>: Jan 23, 2020 10:10 P.M. UTC</p><p><b>End</b>: Jan 23, 2020 11:10 P.M. UTC</p><p><b>Participants</b>:</p><dl><dd><b>Location</b>: Endoscopy</dd><dd><b>Other Resource</b>: Endoscopy Rooms</dd><dd><b>Patient</b>: Smart II, Nancy</dd></dl></div>'
},
'extension': [
{
'valueString': '',
'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/action-comment'
},
{
'valueBoolean': false,
'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/is-cancelable'
},
{
'valueBoolean': false,
'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/is-reschedulable'
}
],
'status': 'cancelled',
'cancelationReason': {
'coding': [
{
'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14229',
'code': '0',
'userSelected': true
}
]
},
'serviceType': [
{
'coding': [
{
'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14249',
'code': '4047611',
'display': 'Surgery Rapid',
'userSelected': true
},
{
'system': 'http://snomed.info/sct',
'code': '394576009',
'display': 'Accident & emergency (qualifier value)',
'userSelected': false
}
],
'text': 'Surgery Rapid'
}
],
'reasonCode': [
{
'text': 'I have a cramp'
}
],
'description': 'Surgery Rapid',
'start': '2020-01-23T22:10:00Z',
'end': '2020-01-23T23:10:00Z',
'minutesDuration': 60,
'participant': [
{
'actor': {
'reference': 'Location/32216049',
'display': 'Endoscopy'
},
'required': 'required',
'status': 'accepted'
},
{
'type': [
{
'coding': [
{
'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14250',
'code': '269829903',
'display': 'Endoscopy Rooms',
'userSelected': true
}
],
'text': 'Endoscopy Rooms'
},
{
'coding': [
{
'system': 'http://terminology.hl7.org/CodeSystem/v3-ParticipationType',
'code': 'PPRF',
'display': 'primary performer'
}
]
}
],
'actor': {
'display': 'Endoscopy Rooms'
},
'required': 'required',
'status': 'accepted'
},
{
'type': [
{
'coding': [
{
'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14250',
'code': '4572',
'display': 'Patient',
'userSelected': true
}
],
'text': 'Patient'
}
],
'actor': {
'reference': 'Patient/12724066',
'display': 'Smart II, Nancy'
},
'required': 'required',
'status': 'accepted',
'period': {
'start': '2023-07-26T14:00:00Z',
'end': '2023-07-26T15:00:00Z'
}
}
],
'requestedPeriod': [
{
'start': '2020-01-23T22:10:00Z',
'end': '2020-01-23T23:10:00Z'
}
]
}
}
Headers
-
X-Request-Id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
X-Request-Id
, if present. -
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
opc-Request-Id
, if present.
x-retrieve-booked Response
Example retrieval of a booked
appointment.
GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Appointment/4874055
Example Response:
{
'resourceType': 'Appointment',
'id': '4874055',
'meta': {
'versionId': '1',
'lastUpdated': '2021-01-22T21:54:05Z'
},
'text': {
'status': 'generated',
'div': '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Appointment</b></p><p><b>Status</b>: Booked</p><p><b>Service Type</b>: EVisit</p><p><b>Start</b>: Jan 20, 2021 1:51 P.M. CST</p><p><b>End</b>: Jan 20, 2021 1:51 P.M. CST</p><p><b>Participants</b>:</p><dl><dd><b>Location</b>: MxClinUmb</dd><dd><b>Practitioner</b>: Cerner Test, Physician - Psychiatry Cerner</dd><dd><b>Patient</b>: SMITH, FRANK</dd></dl></div>'
},
'extension': [
{
'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/action-comment'
},
{
'valueBoolean': false,
'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/is-cancelable'
},
{
'valueBoolean': false,
'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/is-reschedulable'
},
{
'valueReference': {
'reference': 'Encounter/97733442'
},
'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/associated-encounter'
}
],
'status': 'booked',
'serviceType': [
{
'coding': [
{
'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14249',
'code': '2572296423',
'display': 'EVisit',
'userSelected': true
},
{
'system': 'http://snomed.info/sct',
'code': '394581000',
'display': 'Community medicine (qualifier value)',
'userSelected': false
}
],
'text': 'EVisit'
}
],
'reasonCode': [
{
'text': 'Pain'
}
],
'description': 'EVisit',
'start': '2021-01-20T19:51:00Z',
'end': '2021-01-20T19:51:00Z',
'minutesDuration': 0,
'participant': [
{
'actor': {
'reference': 'Location/38930365',
'display': 'MxClinUmb'
},
'required': 'required',
'status': 'accepted'
},
{
'type': [
{
'coding': [
{
'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14250',
'code': '4574',
'display': 'Resource',
'userSelected': true
}
],
'text': 'Resource'
},
{
'coding': [
{
'system': 'http://terminology.hl7.org/CodeSystem/v3-ParticipationType',
'code': 'PPRF',
'display': 'primary performer'
}
]
}
],
'actor': {
'reference': 'Practitioner/4122617',
'display': 'Cerner Test, Physician - Psychiatry Cerner'
},
'required': 'required',
'status': 'accepted'
},
{
'type': [
{
'coding': [
{
'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14250',
'code': '4572',
'display': 'Patient',
'userSelected': true
}
],
'text': 'Patient'
}
],
'actor': {
'reference': 'Patient/12507979',
'display': 'SMITH, FRANK'
},
'required': 'required',
'status': 'tentative',
'period': {
'start': '2021-01-20T19:51:00Z',
'end': '2021-01-20T19:51:00Z'
}
}
],
'requestedPeriod': [
{
'start': '2021-01-20T19:51:00Z',
'end': '2021-01-20T19:51:00Z'
}
]
}
Headers
-
X-Request-Id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
X-Request-Id
, if present. -
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
opc-Request-Id
, if present.
x-retrieve-with-video-visit Response
Example retrieval of an appointment with a video visit.
Example Request:GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Appointment/4817572
Example Response:
{
'resourceType': 'Appointment',
'id': '4817572',
'meta': {
'versionId': '2-1',
'lastUpdated': '2020-07-11T05:05:01.000Z'
},
'text': {
'status': 'generated',
'div': '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Appointment</b></p><p><b>Status</b>: No Show</p><p><b>Service Type</b>: Video Visit</p><p><b>Start</b>: Jul 10, 2020 1:00 P.M. UTC</p><p><b>End</b>: Jul 10, 2020 1:15 P.M. UTC</p><p><b>Slot Id</b>: 21265426-633867-6828001-60</p><p><b>Participants</b>: Patient: SMART, NANCY, Practitioner: Applegate MD, Christina, Location: MX Clinic 1</p><p><b>Video Visit</b>: Yes</p></div>'
},
'contained': [
{
'resourceType': 'HealthcareService',
'id': '28',
'type': [
{
'text': 'Patient Virtual Meeting Room'
}
],
'telecom': [
{
'system': 'url',
'value': 'https://www.google.com/',
'period': {
'start': '2020-07-13T08:00:00.000Z',
'end': '2020-07-13T08:10:00.000Z'
}
}
]
},
{
'resourceType': 'HealthcareService',
'id': '31',
'type': [
{
'text': 'Provider Virtual Meeting Room'
}
],
'telecom': [
{
'system': 'url',
'value': 'https://www.google.com/',
'period': {
'start': '2020-07-13T08:00:00.000Z',
'end': '2020-07-13T08:10:00.000Z'
}
}
]
}
],
'status': 'noshow',
'cancelationReason': {
'coding': [
{
'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14229',
'code': '2191414701',
'display': 'Scheduled by mistake',
'userSelected': true
},
{
'system': 'http://terminology.hl7.org/CodeSystem/appointment-cancellation-reason',
'code': 'oth-err',
'display': 'Other: Error',
'userSelected': false
}
],
'text': 'Scheduled by mistake'
},
'serviceCategory': [
{
'coding': [
{
'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/16127',
'code': '22721463',
'display': 'DIAGNOSTIC',
'userSelected': true
},
{
'system': 'http://snomed.info/sct',
'code': '261004008',
'display': 'Diagnostic intent (qualifier value)',
'userSelected': false
}
],
'text': 'DIAGNOSTIC'
}
],
'serviceType': [
{
'coding': [
{
'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14249',
'code': '2572307911',
'display': 'Video Visit',
'userSelected': true
}
],
'text': 'Video Visit'
}
],
'reasonCode': [
{
'text': 'Testing Video Visit'
}
],
'description': 'Video Visit',
'start': '2020-07-10T13:00:00.000Z',
'end': '2020-07-10T13:15:00.000Z',
'minutesDuration': 15,
'slot': [
{
'reference': 'Slot/21265426-633867-6828001-60'
}
],
'participant': [
{
'type': [
{
'coding': [
{
'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14250',
'code': '4572',
'display': 'Patient',
'userSelected': true
}
],
'text': 'Patient'
}
],
'actor': {
'reference': 'Patient/12724066',
'display': 'SMART, NANCY'
},
'required': 'required',
'status': 'accepted',
'period': {
'start': '2023-07-26T14:00:00Z',
'end': '2023-07-26T15:00:00Z'
}
},
{
'type': [
{
'coding': [
{
'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14250',
'code': '4574',
'display': 'Resource',
'userSelected': true
}
],
'text': 'Resource'
},
{
'coding': [
{
'system': 'http://terminology.hl7.org/CodeSystem/v3-ParticipationType',
'code': 'PPRF',
'display': 'primary performer'
}
]
}
],
'actor': {
'reference': 'Practitioner/593923',
'display': 'Applegate MD, Christina'
},
'required': 'required',
'status': 'accepted'
},
{
'actor': {
'reference': 'Location/21304876',
'display': 'MX Clinic 1'
},
'required': 'required',
'status': 'accepted'
},
{
'type': [
{
'text': 'Patient Virtual Meeting Room'
}
],
'actor': {
'reference': '#28'
},
'status': 'accepted'
},
{
'type': [
{
'text': 'Provider Virtual Meeting Room'
}
],
'actor': {
'reference': '#31'
},
'status': 'accepted'
}
],
'requestedPeriod': [
{
'start': '2020-07-10T13:00:00.000Z',
'end': '2020-07-10T13:15:00.000Z'
}
]
}
Headers
-
X-Request-Id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
X-Request-Id
, if present. -
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
opc-Request-Id
, if present.