Get an allergy by allergy ID

get

/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

Path Parameters
Query Parameters
Header Parameters
  • Specifies which media types are acceptable for the response. Defaults to application/json.
    Default Value: application/json
  • Specifies which character sets are acceptable for the response. Defaults to UTF-8.
    Default Value: UTF-8
  • Contains the credentials to authenticate a consumer to the service.
  • Unique Oracle Health assigned identifier for the request. If you need to contact Oracle about a particular request, provide the request ID. The only valid characters for request IDs are letters, numbers, underscore, and dash.
Back to Top

Response

Supported Media Types

200 Response

Success.
Headers
  • For optimistic concurrency control. See if-match.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Allergy
Type: object
The allergy details.
Show Source
Nested Schema : CodeValueSimple
Type: object
A minimal representation of a code value.
Show Source
Nested Schema : PersonSimple
Type: object
A simple representation of the individual person that was retrieved. The individual could be a personnel member (provider), a patient, or a nonpatient person.
Show Source
Nested Schema : notes
Type: array
Unique Items Required: true
The list of notes added to this allergy. This value can be empty.
Show Source
Nested Schema : AllergyFuzzyDateTime
Type: 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.

Show Source
Nested Schema : permissions
Type: array
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.

Show Source
Nested Schema : reactions
Type: array
Unique Items Required: true
A list of reactions associated with this allergy. This list can be empty.
Show Source
Nested Schema : ReviewInfo
Type: object
The information around who and when the data was reviewed.
Show Source
Nested Schema : AllergyStatus
Type: object
The allergy status details.
Show Source
Nested Schema : NomenclatureOrFreetextValue
Type: object
The nomenclature or free text value of the data.
Show Source
Nested Schema : PersonNameSummary
Type: object
A summary of just first, last, and full name for a person (which could be a personnel member, patient, or nonpatient person).
Show Source
Nested Schema : Annotation
Type: object
A text note that also contains information about who made the statement and when.
Show Source
  • PersonSimple
    A simple representation of the individual person that was retrieved. The individual could be a personnel member (provider), a patient, or a nonpatient person.
  • 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.
  • The annotation text
Nested Schema : DateTimeStringWithZone
Type: object
Representation of the date and time with time zone.
Show Source
  • 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.
  • The time zone, provided that the date includes time precision. If dateTime contains time, then this value is required.
Nested Schema : AllergyFuzzyDateTimePrecision
Type: object
A code value representation of the precision associated with a date.
Show Source
  • The display for the code value.
    Example: Display
  • The ID of the code value.
    Example: 1643574645
  • 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.
Nested Schema : AllergyFuzzyDateTimeUnit
Type: object
A display and enumerated meaning structure representing the date and time unit like DAY, WEEK, MONTH, and YEAR.
Show Source
  • The display for the date and time unit.
    Example: Date
  • Allowed Values: [ "TIME", "DAY", "WEEK", "MONTH", "YEAR" ]
    The unit associated with the fuzzy date.
    Example: DAY
Nested Schema : AllergyReaction
Type: object
The allergy reaction details.
Show Source
Nested Schema : DateTimeWithZone
Type: object
A representation of the date and time with the time zone.
Show Source
  • 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/time.
  • The time zone, provided that the date includes time precision. If dateTime contains time, then this field is required.
Nested Schema : NomenclatureSimple
Type: object
The model object for a nomenclature.
Show Source

400 Response

Bad Request
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : ApiError
Type: object
Error information.
Show Source
Nested Schema : details
Type: array
A list of details regarding any and all errors from the resulting service request.
Show Source
Nested Schema : ErrorDetail
Type: object
Additional detail information pertaining to the error.
Show Source
Nested Schema : ErrorDetailSource
Type: object
An object containing references to the source of the error.
Show Source
  • headers
    A list of the request headers that caused the error.
  • parameters
    A list of which URI query parameters caused the error.
  • 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 exist, the client should ignore the pointer.
Nested Schema : headers
Type: array
A list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type: array
A list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type: 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 exist, the client should ignore the pointer.
Show Source

401 Response

Unauthorized
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : ApiError
Type: object
Error information.
Show Source
Nested Schema : details
Type: array
A list of details regarding any and all errors from the resulting service request.
Show Source
Nested Schema : ErrorDetail
Type: object
Additional detail information pertaining to the error.
Show Source
Nested Schema : ErrorDetailSource
Type: object
An object containing references to the source of the error.
Show Source
  • headers
    A list of the request headers that caused the error.
  • parameters
    A list of which URI query parameters caused the error.
  • 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 exist, the client should ignore the pointer.
Nested Schema : headers
Type: array
A list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type: array
A list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type: 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 exist, the client should ignore the pointer.
Show Source

403 Response

NotAuthorized
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : ApiError
Type: object
Error information.
Show Source
Nested Schema : details
Type: array
A list of details regarding any and all errors from the resulting service request.
Show Source
Nested Schema : ErrorDetail
Type: object
Additional detail information pertaining to the error.
Show Source
Nested Schema : ErrorDetailSource
Type: object
An object containing references to the source of the error.
Show Source
  • headers
    A list of the request headers that caused the error.
  • parameters
    A list of which URI query parameters caused the error.
  • 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 exist, the client should ignore the pointer.
Nested Schema : headers
Type: array
A list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type: array
A list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type: 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 exist, the client should ignore the pointer.
Show Source

404 Response

Not Found
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : ApiError
Type: object
Error information.
Show Source
Nested Schema : details
Type: array
A list of details regarding any and all errors from the resulting service request.
Show Source
Nested Schema : ErrorDetail
Type: object
Additional detail information pertaining to the error.
Show Source
Nested Schema : ErrorDetailSource
Type: object
An object containing references to the source of the error.
Show Source
  • headers
    A list of the request headers that caused the error.
  • parameters
    A list of which URI query parameters caused the error.
  • 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 exist, the client should ignore the pointer.
Nested Schema : headers
Type: array
A list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type: array
A list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type: 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 exist, the client should ignore the pointer.
Show Source

429 Response

Too Many Requests
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : ApiError
Type: object
Error information.
Show Source
Nested Schema : details
Type: array
A list of details regarding any and all errors from the resulting service request.
Show Source
Nested Schema : ErrorDetail
Type: object
Additional detail information pertaining to the error.
Show Source
Nested Schema : ErrorDetailSource
Type: object
An object containing references to the source of the error.
Show Source
  • headers
    A list of the request headers that caused the error.
  • parameters
    A list of which URI query parameters caused the error.
  • 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 exist, the client should ignore the pointer.
Nested Schema : headers
Type: array
A list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type: array
A list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type: 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 exist, the client should ignore the pointer.
Show Source

500 Response

Internal Server Error
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : ApiError
Type: object
Error information.
Show Source
Nested Schema : details
Type: array
A list of details regarding any and all errors from the resulting service request.
Show Source
Nested Schema : ErrorDetail
Type: object
Additional detail information pertaining to the error.
Show Source
Nested Schema : ErrorDetailSource
Type: object
An object containing references to the source of the error.
Show Source
  • headers
    A list of the request headers that caused the error.
  • parameters
    A list of which URI query parameters caused the error.
  • 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 exist, the client should ignore the pointer.
Nested Schema : headers
Type: array
A list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type: array
A list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type: 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 exist, the client should ignore the pointer.
Show Source
Back to Top