Get a list of document references with $docref
get
/DocumentReference/$docref
Argonaut operation for querying DocumentReferences for the supplied parameters.
Terminology Bindings
- DocumentReference.type
- Description: The precise type of clinical document
- Details: LOINC
- System:
http://loinc.org
- DocumentReference.content.format
- Description: The document format codes.
- Details: DocumentReference Format Code Set
- System:
urn:oid:1.3.6.1.4.1.19376.1.2.3
Authorization Types
This operation supports the following authorization types:
- Provider
- Patient
- System
Request
Query Parameters
-
end: string
The end of the date range until which document reference records should be included.
- Must be valid dateTime values with a time component.
- Must have prefixes of
eq
or nothing. - If
start
is not provided, then all previous records up to theend
date are included. - If
end
is not provided, then all records between thestart
date and the current date are included.
end=2016-09-24T12:00:00.000Z
-
patient(required): string
A reference to the patient whose document references are required.
Example:patient=12345
-
start: string
The start of the date range from which document reference records should be included.
- Must be valid dateTime values with a time component.
- Must have prefixes of
eq
or nothing. - If
start
is not provided, then all previous records up to theend
date are included. - If
end
is not provided, then all records between thestart
date and the current date are included.
start=2014-09-24T12:00:00.000Z
-
type(required): string
The document reference type.
- Must include both a system and a code. Example:
&type=http://loinc.org|34133-9
. - May be a single system and code or a comma-separated list.
type=http://loinc.org|34133-9
- Must include both a system and a code. Example:
Header Parameters
-
Accept(required): string
The media type to be requested. See what the resource's operation produces for what is supported.
-
Authorization(required): string
Contains the credentials to authenticate a consumer to the service. This should be the OAuth2 Bearer token.
Response
Supported Media Types
- application/json+fhir
- application/json
Default Response
Example Request:
GET https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/DocumentReference/$docref?patient=12724066&type=http%3A%2F%2Floinc.org%7C34133-9
Example Response:
{
'resourceType': 'Bundle',
'id': '33c6587c-ab3c-4846-a2c6-05724fe4013e',
'type': 'searchset',
'total': 1,
'link': [
{
'relation': 'self',
'url': 'https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/DocumentReference/$docref?patient=12724066&type=http%3A%2F%2Floinc.org%7C34133-9'
}
],
'entry': [
{
'fullUrl': 'https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/DocumentReference/c7d249c7-1742-47a8-9fca-1fc361728aa8',
'resource': {
'resourceType': 'DocumentReference',
'id': 'c7d249c7-1742-47a8-9fca-1fc361728aa8',
'subject': {
'reference': 'Patient/12724066'
},
'type': {
'coding': [
{
'system': 'http://loinc.org',
'code': '34133-9'
}
],
'text': 'Summary of episode note'
},
'indexed': '2020-07-08T17:05:01Z',
'status': 'current',
'content': [
{
'attachment': {
'contentType': 'application/xml',
'url': 'https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Binary/$autogen-ccd-if?patient=12724066'
},
'format': [
{
'system': 'urn:oid:1.3.6.1.4.1.19376.1.2.3',
'code': 'urn:hl7-org:sdwg:ccda-structuredBody:2.1',
'display': 'For documents following C-CDA constraints using a structured body.'
}
]
}
]
}
}
]
}
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.