Get a condition by condition identifier
get
/20240101/conditions/{conditionId}
Retrieves a condition by condition identifier.
Request
Path Parameters
-
conditionId(required): string
The unique identifier for the condition to retrieve.
Query Parameters
-
encounterId: string
The encounter ID to filter the resource query against.
-
patientId(required): string
The patient ID to filter the resource query against.
Header Parameters
-
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 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.
Response
Supported Media Types
- application/json
200 Response
Success.
Headers
-
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.
Root Schema : Condition
The response model for the detailed condition response.
Match All
The response model for the detailed condition response.
The response model for the detailed condition response.
Show Source
-
allOf
ConditionBase
A base model object with common properties in a condition.
-
object
Condition-allOf[1]
Nested Schema : ConditionBase
A base model object with common properties in a condition.
Match All
A base model object with common properties in a condition.
A base model object with common properties in a condition.
Show Source
-
object
EntityBase
Contains common properties across entity and conditions.
-
object
ConditionBase-allOf[1]
Nested Schema : EntityBase
Type:
objectContains common properties across entity and conditions.
Show Source
-
acuteNomenclature:
object NomenclatureSimple
The model object for a nomenclature.
-
acuteType:
object CodeValueSimple
A minimal representation of a code value.
-
chronicNomenclature:
object NomenclatureSimple
The model object for a nomenclature.
-
chronicStatus:
object CodeValueSimple
A minimal representation of a code value.
-
classification:
object CodeValueSimple
A minimal representation of a code value.
-
confirmation:
object CodeValueSimple
A minimal representation of a code value.
-
createdBy:
object 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.
-
laterality:
object CodeValueSimple
A minimal representation of a code value.
-
nomenclature:
object NomenclatureSimple
The model object for a nomenclature.
-
onsetDate:
object FuzzyDate
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 with the provided date 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 FuzzyDateUnit or FuzzyDatePrecision values are supported by that API.
-
resolutionDate:
object FuzzyDate
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 with the provided date 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 FuzzyDateUnit or FuzzyDatePrecision values are supported by that API.
Nested Schema : ConditionBase-allOf[1]
Type:
Show Source
object-
acuteDate:
string(date)
The ISO-8601 representation of the acute diagnosis date associated with the condition. This representation is only applicable to an acute condition and does not include any time information.Example:
2016-10-20 -
displayName:
string
The name of patient's condition, for example,
anemia.Example:Anemia -
id(required):
string
The unique identifier for the condition.Example:
CODIFIED_123_456 -
sensitivity:
object Sensitivity
Sensitivity attributes are related to conditions that could be sensitive to expose, such as mental health details, sexually transmitted diseases, substance abuse history, or HIV status. Sensitivity labels help ensure that such information is handled with extra care, accessed only by authorized personnel, and not inadvertently disclosed.
-
specificity:
string
Allowed Values:
[ "SPECIFIED", "NOT_SPECIFIED", "NOT_ACTIONABLE" ]The specificity of the condition's acute nomenclature. Typically populated when the condition is associated with this visit, but use caution when consuming this enum in case it is not populated or has a value other than those listed.
Nested Schema : Condition-allOf[1]
Type:
Show Source
object-
commentList:
array commentList
The list of comments for the condition in reverse chronological order.
-
entityList:
array entityList
The list of the individual acute and chronic entities that make up the condition.
-
mostRecentReview:
object ConditionReview
A review involves assessing the current status of the condition and determining whether it has improved, worsened, or remained stable. This assessment helps in deciding whether the ongoing treatment is effective or if adjustments are needed. Based on the review, treatment plans may be updated to better address the condition. An update might include changes in medication, therapy, or other interventions.
-
summary:
object Summary
The model object representing a summary associated with a condition.
Nested Schema : NomenclatureSimple
Type:
objectThe model object for a nomenclature.
Show Source
-
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.
Nested Schema : CodeValueSimple
Type:
objectA minimal representation of a code value.
Show Source
-
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.
Nested Schema : PersonSimple
Type:
objectA 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
-
id(required):
string
The unique identifier for the individual.
-
name:
object PersonNameSummary
A summary of just first, last, and full name for a person (which could be a personnel member, patient, or nonpatient person).
Nested Schema : FuzzyDate
Type:
objectThe 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 with the provided date 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
FuzzyDateUnit or FuzzyDatePrecision values are supported by that API.
Show Source
-
date:
string(date)
The date represented in YYYY-MM-DD format as defined by RFC 3339. No time zone information is associated with this date.
-
precision:
object FuzzyDatePrecision
A code value representation of the precision associated with a date.
-
unit:
object FuzzyDateUnit
A display and enumerated meaning structure representing date unit such as DAY, WEEK, MONTH, YEAR.
Nested Schema : PersonNameSummary
Type:
objectA summary of just first, last, and full name for a person (which could be a personnel member, patient, or nonpatient person).
Show Source
-
firstName:
string
The person's first given name.
-
fullName:
string
The fully formatted name.
-
lastName:
string
The person's family last name.
Nested Schema : FuzzyDatePrecision
Type:
objectA code value representation of the precision associated with a date.
Show Source
-
display(required):
string
The display for the code value.Example:
Display -
meaning:
string
Allowed Values:
[ "ABOUT", "AFTER", "AGE", "BEFORE", "UNKNOWN" ]The enumerated meaning of the code value. Should almost always be populated, but use caution when consuming this enum in case it is not populated or has a value other than those listed.
Nested Schema : FuzzyDateUnit
Type:
objectA display and enumerated meaning structure representing date unit such as DAY, WEEK, MONTH, YEAR.
Show Source
-
display(required):
string
Display for the date unit.Example:
Date -
meaning:
string
Allowed Values:
[ "DAY", "WEEK", "MONTH", "YEAR" ]The enumerated meaning of the date unit. Should almost always be populated, but use caution when consuming this enum in case it is not populated or has a value other than those listed.Example:DAY
Nested Schema : Sensitivity
Type:
objectSensitivity attributes are related to conditions that could be sensitive to expose, such as mental health details,
sexually transmitted diseases, substance abuse history, or HIV status. Sensitivity labels help ensure that such
information is handled with extra care, accessed only by authorized personnel, and not inadvertently disclosed.
Show Source
-
lastModifiedBy:
object 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.
-
sensitivityLabels:
array sensitivityLabels
The sensitivity labels associated with the condition.
Nested Schema : sensitivityLabels
Type:
arrayThe sensitivity labels associated with the condition.
Show Source
-
Array of:
object CodeValueSimple
A minimal representation of a code value.
Nested Schema : commentList
Type:
arrayThe list of comments for the condition in reverse chronological order.
Show Source
-
Array of:
object Comment
Comment details
Nested Schema : entityList
Type:
arrayThe list of the individual acute and chronic entities that make up the condition.
Show Source
Nested Schema : ConditionReview
Type:
objectA review involves assessing the current status of the condition and determining whether it has improved, worsened,
or remained stable. This assessment helps in deciding whether the ongoing treatment is effective or if
adjustments are needed. Based on the review, treatment plans may be updated to better address the condition.
An update might include changes in medication, therapy, or other interventions.
Show Source
-
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 nonpatient person.
-
reviewedDateTime(required):
string(date-time)
The ISO-8601 representation of the date and time the review was performed.Example:
2016-10-8T01:02:03Z
Nested Schema : Summary
Type:
objectThe model object representing a summary associated with a condition.
Show Source
-
isActive(required):
boolean
An active condition is current or ongoing, may require active management, and is clinically significant.
- Current or ongoing: The condition is currently affecting the patient as an
ongoing issue that requires medical attention, monitoring, or treatment. In contrast, conditions
that have been resolved or are in remission might be labeled as
inactiveorresolved. - Requires active management: The active status may also imply that the condition requires active management, such as medication, therapy, or other forms of treatment to control its symptoms or progression.
- Clinical significance: An active condition is clinically significant for the patient's current health status and care planning. The condition is relevant to the decisions made by healthcare providers regarding the patient's care and treatment.
- Current or ongoing: The condition is currently affecting the patient as an
ongoing issue that requires medical attention, monitoring, or treatment. In contrast, conditions
that have been resolved or are in remission might be labeled as
-
isCombined(required):
boolean
Conditions that are combined into a single summary might be interrelated, meaning that one condition could influence the development or management of another. For example, diabetes and hypertension are often interrelated and may be managed more effectively when considered together in a patient's care plan.
-
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 nonpatient person.
-
recordedDateTime(required):
string(date-time)
The ISO-8601 representation of the date and time when the summary was recorded. The date and time are in UTC and can be converted to the local time zone if needed.Example:
2016-10-8T05:02:03Z -
text(required):
string
A textual description of the condition's summary. See example for more information.Example:
<p><b>Hypertension</b></p> <p>Patient developed Hypertension in 1983. His blood pressure peaked at 160/95.</p> <p>He was placed on HCTZ and it quickly escalated to Lisinopril/HCTZ. In 2005 he added Atenolol.</p> <p>His blood pressures have been under control since.</p> <p>He exercises 20 minutes 3x/week and is on a regular diet.</p>
Nested Schema : Comment
Type:
objectComment details
Show Source
-
comment:
string
The comment text.
-
commentDateTime:
object DateTimeWithZone
A representation of the date and time with the time zone.
-
commentedBy:
object 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.
-
id:
string
The unique identifier of the comment.
Nested Schema : DateTimeWithZone
Type:
objectA representation of the date and time with the time zone.
Show Source
-
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 timezone information is associated with this date/time.
-
ianaTimeZone:
string
The time zone, provided that the date includes time precision. If
dateTimecontains time, then this field is required.
Nested Schema : Entity
The model object representing a detailed condition entity.
Match All
The model object representing a detailed condition entity.
The model object representing a detailed condition entity.
Show Source
-
object
EntityBase
Contains common properties across entity and conditions.
-
object
Entity-allOf[1]
Nested Schema : Entity-allOf[1]
Type:
Show Source
object-
acuteDate:
string(date)
Represents only the acute diagnosis date associated with the condition and is only applicable to an acute entity. This date does not include any time information.Example:
2016-10-20 -
beginEffectiveDateTime:
string(date-time)
The date and time when the condition entity became effective.Example:
2016-10-20T01:02:03Z -
displayName:
string
The display value of the entity.Example:
Anemia Annotated -
encounterId:
string
The identifier of the encounter (visit) that this entity is associated with. This identifier is only applicable to an acute entity.Example:
1654324 -
id(required):
string
The unique identifier of the entity. This value does not change over the life of an entity.Example:
950109285 -
isResolved(required):
boolean
If true, the problem is resolved or no longer relevant
-
lastModifiedDateTime:
string(date-time)
The date and time when the condition entity was last updated.Example:
2016-10-20T01:02:03Z -
lastModifiedPersonnelId:
string
The ID of the last personnel member to update the condition entity.
-
type:
string
Allowed Values:
[ "ACUTE", "CHRONIC" ]The type of the entity. Typically populated, but use caution when consuming this enum in case it is not populated or has a value other than those listed. -
version(required):
string
The version of the specific instance that represents the current state of the entity. This value can change as the entity is modified.Example:
950109286
400 Response
Bad Request
Headers
-
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.
Root Schema : ApiError
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any and all errors from the resulting service request.
-
message(required):
string
A human-readable error message.
Nested Schema : details
Type:
arrayA list of details regarding any and all errors from the resulting service request.
Show Source
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
Nested Schema : ErrorDetail
Type:
objectAdditional detail information pertaining to the error.
Show Source
-
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.
Nested Schema : ErrorDetailSource
Type:
objectAn object containing references to the source of the error.
Show Source
-
headers:
array headers
A list of the request headers that 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,
/datafor a primary data object, or/data/attributes/titlefor 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:
arrayA list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type:
arrayA list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type:
arrayA list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
Show Source
/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.
401 Response
Unauthorized
Headers
-
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.
Root Schema : ApiError
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any and all errors from the resulting service request.
-
message(required):
string
A human-readable error message.
Nested Schema : details
Type:
arrayA list of details regarding any and all errors from the resulting service request.
Show Source
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
Nested Schema : ErrorDetail
Type:
objectAdditional detail information pertaining to the error.
Show Source
-
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.
Nested Schema : ErrorDetailSource
Type:
objectAn object containing references to the source of the error.
Show Source
-
headers:
array headers
A list of the request headers that 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,
/datafor a primary data object, or/data/attributes/titlefor 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:
arrayA list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type:
arrayA list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type:
arrayA list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
Show Source
/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.
404 Response
Not Found
Headers
-
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.
Root Schema : ApiError
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any and all errors from the resulting service request.
-
message(required):
string
A human-readable error message.
Nested Schema : details
Type:
arrayA list of details regarding any and all errors from the resulting service request.
Show Source
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
Nested Schema : ErrorDetail
Type:
objectAdditional detail information pertaining to the error.
Show Source
-
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.
Nested Schema : ErrorDetailSource
Type:
objectAn object containing references to the source of the error.
Show Source
-
headers:
array headers
A list of the request headers that 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,
/datafor a primary data object, or/data/attributes/titlefor 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:
arrayA list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type:
arrayA list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type:
arrayA list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
Show Source
/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.
429 Response
Too Many Requests
Headers
-
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.
Root Schema : ApiError
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any and all errors from the resulting service request.
-
message(required):
string
A human-readable error message.
Nested Schema : details
Type:
arrayA list of details regarding any and all errors from the resulting service request.
Show Source
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
Nested Schema : ErrorDetail
Type:
objectAdditional detail information pertaining to the error.
Show Source
-
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.
Nested Schema : ErrorDetailSource
Type:
objectAn object containing references to the source of the error.
Show Source
-
headers:
array headers
A list of the request headers that 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,
/datafor a primary data object, or/data/attributes/titlefor 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:
arrayA list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type:
arrayA list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type:
arrayA list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
Show Source
/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.
500 Response
Internal Server Error
Headers
-
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.
Root Schema : ApiError
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any and all errors from the resulting service request.
-
message(required):
string
A human-readable error message.
Nested Schema : details
Type:
arrayA list of details regarding any and all errors from the resulting service request.
Show Source
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
Nested Schema : ErrorDetail
Type:
objectAdditional detail information pertaining to the error.
Show Source
-
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.
Nested Schema : ErrorDetailSource
Type:
objectAn object containing references to the source of the error.
Show Source
-
headers:
array headers
A list of the request headers that 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,
/datafor a primary data object, or/data/attributes/titlefor 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:
arrayA list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type:
arrayA list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type:
arrayA list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
Show Source
/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.