Get an allergy by allergy ID
/20240101/allergies/{allergyId}
Retrieves an allergy for the given patient ID and allergy ID.
Note: If no allergy is found with the given allergy ID and patient ID, a 404 Not Found response is returned.Request
-
allergyId(required): string
The unique identifier of the allergy.
-
patientId(required): string
Identifier of patient to filter the resource query against.
-
accept: string
Specifies which media types are acceptable for the response. Defaults to
application/json
.Default Value:application/json
-
accept-charset: string
Specifies which character sets are acceptable for the response. Defaults to
UTF-8
.Default Value:UTF-8
-
authorization(required): string
Contains the credentials to authenticate a consumer to the service.
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID. The only valid characters for request IDs are letters, numbers, underscore, and dash.
Response
- application/json
200 Response
-
etag: string
For optimistic concurrency control. See
if-match
. -
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
object
-
cancelReason:
object CodeValueSimple
A minimal representation of a code value.
-
category:
object CodeValueSimple
A minimal representation of a code value.
-
createdBy(required):
object PersonSimple
A simple representation of the individual person that was retrieved.
The individual could be a personnel member (provider), a patient, or a non-patient person.
-
createdDateTime(required):
string(date-time)
The date and time that the allergy was created in the ISO-8601 representation of the date and time format (YYYY-MM-DDTHH:MM:SS:SSSZ) as defined by RFC 3339.Example:
2018-06-16T21:31:35.457Z
-
criticality:
object CodeValueSimple
A minimal representation of a code value.
-
encounterId:
string
The unique identifier of the encounter that the allergy was added to.
If no encounter is associated with the allergy, then this value is omitted.
-
id(required):
string
The unique identifier of the allergy.
-
infoSource:
object CodeValueSimple
A minimal representation of a code value.
-
isPharmacyVerified:
boolean
Default Value:
false
The indicator that denotes if the allergy is verified by a pharmacy. -
lastModifiedBy(required):
object PersonSimple
A simple representation of the individual person that was retrieved.
The individual could be a personnel member (provider), a patient, or a non-patient person.
-
lastModifiedDateTime(required):
string(date-time)
The date and time that the allergy was last modified in the ISO-8601 representation of the date and time format (YYYY-MM-DDTHH:MM:SS:SSSZ) as defined by RFC 3339.Example:
2018-06-16T21:31:35.457Z
-
notes:
array notes
Unique Items Required:
true
The list of notes added to this allergy. This value can be empty. -
onBehalfOf:
object PersonSimple
A simple representation of the individual person that was retrieved.
The individual could be a personnel member (provider), a patient, or a non-patient person.
-
onset:
object AllergyFuzzyDateTime
The model object for a fuzzy date associated with a clinical concept with a corresponding precision and unit applied to it.
The precision and unit are used in conjunction with the provided date and time to communicate a possibly imprecise date, for example, Age 28 or Sometime After 2020-04. Note that the
/referenceData
for a given API should be queried to confirm exactly whichFuzzyDateTimeUnit
orFuzzyDateTimePrecision
values are supported by that API. -
organizationId:
string
The unique identifier of the organization.
-
patient(required):
object PersonSimple
A simple representation of the individual person that was retrieved.
The individual could be a personnel member (provider), a patient, or a non-patient person.
-
permissions:
array permissions
Unique Items Required:
true
The set of allergy related permissions granted to the requesting user.
MODIFY_ALLERGY
indicates that the user has permission to modify the existing allergy. -
reactions:
array reactions
Unique Items Required:
true
A list of reactions associated with this allergy. This list can be empty. -
reactionType:
object CodeValueSimple
A minimal representation of a code value.
-
reviewInfo:
object ReviewInfo
The information around who and when the data was reviewed.
-
status:
object AllergyStatus
The allergy status details.
-
substance(required):
object NomenclatureOrFreetextValue
The nomenclature or free text value of the data.
-
version(required):
string
The unique identifier of this version of the allergy.
object
-
cdfMeaning:
string
A programmatic value, primarily used by applications to search for this value.
-
display:
string
The text consumers see that represents this code value.
-
id(required):
string
The ID of the code value.
object
A simple representation of the individual person that was retrieved.
The individual could be a personnel member (provider), a patient, or a non-patient person.
-
id(required):
string
The unique identifier for the individual.
-
name:
object PersonNameSummary
A summary of the first, last, and full name for a person. The person could be a personnel member, patient, or non-patient person.
array
true
-
Array of:
object Annotation
A text note that also contains information about who made the statement and when.
object
The model object for a fuzzy date associated with a clinical concept with a corresponding precision and unit applied to it.
The precision and unit are used in conjunction with the provided date and time to communicate a possibly imprecise date, for example,
Age 28 or Sometime After 2020-04. Note that the /referenceData
for a given API should be queried to confirm exactly which
FuzzyDateTimeUnit
or FuzzyDateTimePrecision
values are supported by that API.
-
dateTime:
object DateTimeStringWithZone
Representation of the date and time with time zone.
-
precision:
object AllergyFuzzyDateTimePrecision
A code value representation of the precision associated with a date.
-
unit:
object AllergyFuzzyDateTimeUnit
A display and enumerated meaning structure representing the date and time unit like
DAY
,WEEK
,MONTH
, andYEAR
.
array
true
The set of allergy related permissions granted to the requesting user.
MODIFY_ALLERGY
indicates that the user has permission to modify the existing allergy.
-
Array of:
string
Allowed Values:
[ "MODIFY_ALLERGY" ]
array
true
-
Array of:
object AllergyReaction
The allergy reaction details.
object
-
reviewedBy(required):
object PersonSimple
A simple representation of the individual person that was retrieved.
The individual could be a personnel member (provider), a patient, or a non-patient person.
-
reviewedDateTime(required):
object DateTimeWithZone
Representation of date and time with the time zone.
object
-
lastModifiedDateTime:
string(date-time)
The date and time when the status was last updated in the ISO-8601 representation of the date and time format (YYYY-MM-DDTHH:MM:SS:SSSZ) as defined by RFC 3339.Example:
2018-06-16T21:31:35.457Z
-
value:
object CodeValueSimple
A minimal representation of a code value.
object
-
freeText:
string
The free text display of the data. This display is returned only if the type is
FREE_TEXT
. -
nomenclature:
object NomenclatureSimple
The model object for a nomenclature.
-
type(required):
string
Allowed Values:
[ "NOMENCLATURE", "FREE_TEXT" ]
The type of value the data is captured as.
object
-
firstName:
string
The person's first given name.
-
fullName:
string
The fully formatted name.
-
lastName:
string
The person's family last name.
object
-
author:
object PersonSimple
A simple representation of the individual person that was retrieved.
The individual could be a personnel member (provider), a patient, or a non-patient person.
-
dateTime:
string(date-time)
The date and time represented in the format (YYYY-MM-DDTHH:MM:SS:SSSZ) without the UTC offset as defined by RFC 3339. No time zone information is associated with this date and time.
-
text:
string
The annotation text
object
-
dateTime:
string
The date and time represented in YYYY-MM-DDTHH:MM:SS:SSSZ format without the UTC offset as defined by RFC 3339.
No timezone information is associated with this date and time. -
ianaTimeZone:
string
The time zone, provided that the date includes time precision. If
dateTime
contains time, then this value is required.
object
-
display(required):
string
The display for the code value.Example:
Display
-
id(required):
string
The ID of the code value.Example:
1643574645
-
meaning:
string
Allowed Values:
[ "ABOUT", "AFTER", "AGE", "BEFORE", "UNKNOWN" ]
The enumerated meaning of the code value. Should almost always be populated, but caution should be taken when consuming this enum in case it is not populated or has a value other than those listed.
object
DAY
, WEEK
, MONTH
, and YEAR
.-
display(required):
string
The display for the date and time unit.Example:
Date
-
meaning:
string
Allowed Values:
[ "TIME", "DAY", "WEEK", "MONTH", "YEAR" ]
The unit associated with the fuzzy date.Example:DAY
object
-
id:
string
The unique identifier of the reaction.
-
isActive:
boolean
Default Value:
false
The status of the reaction. Returns true if the reaction is active. The default is false. -
lastModifiedDateTime:
string(date-time)
The date and time that the reaction was updated in the ISO-8601 representation of the date and time format (YYYY-MM-DDTHH:MM:SS:SSSZ) as defined by RFC 3339.Example:
2018-06-16T21:31:35.457Z
-
severity:
object CodeValueSimple
A minimal representation of a code value.
-
symptom(required):
object NomenclatureOrFreetextValue
The nomenclature or free text value of the data.
object
-
dateTime:
string(date-time)
The date and time represented in YYYY-MM-DDTHH:MM:SS:SSSZ format without the UTC offset as defined by RFC 3339.
No time zone information is associated with this date and time.
-
ianaTimeZone:
string
The time zone, provided that the date includes time precision. If
dateTime
contains time, this value is required.
object
-
code:
string
The universal clinical code of the term.Example:
452.5b
-
conceptCki:
string
The concept CKI of the nomenclature.
-
displayName:
string
The display of the nomenclature.Example:
Anemia Nomenclature
-
id(required):
string
The unique identifier of the nomenclature.Example:
1643574645
-
terminology:
object CodeValueSimple
A minimal representation of a code value.
-
terminologyAxis:
object CodeValueSimple
A minimal representation of a code value.
400 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
401 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
403 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
404 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
429 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
500 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.