Get a list of conditions for a patient
get
/20240101/conditions
Retrieves conditions for a given patient. If an
encounterId filter is provided, then only acutes identified
in the specified encounter are provided. Otherwise, both chronic and acutes are returned, without being filtered
to any specific encounters.
Request
Query Parameters
-
encounterId: string
The encounter ID to filter the resource query against.
-
limit: integer
Minimum Value:
1000Maximum Value:1000For list pagination. The maximum number of results per page, or items to return in a paginated List request.Default Value:1000 -
page: string
Minimum Length:
1For list pagination. The value of the opc-next-page response header from the previous List request. -
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
-
opc-next-page: string
For list pagination. When this header appears in the response, additional pages of results remain.
-
opc-prev-page: string
For list pagination. When this header appears in the response, additional pages of results remain.
-
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 : ConditionsCollection
Type:
objectThe model object for ConditionsCollection.
Show Source
-
items(required):
array items
A list of conditions.
-
status(required):
string
Allowed Values:
[ "CHRONIC_PROBLEM_EXISTS", "NO_KNOWN_PROBLEMS" ]A set of condition-related permissions granted to the requesting user.- CHRONIC_PROBLEM_EXISTS: A minimum of one chronic problem exists.
- NO_KNOWN_PROBLEMS: The patient has indicated to a provider that they have No Known Problems (NKP).
Nested Schema : items
Type:
arrayA list of conditions.
Show Source
-
Array of:
ConditionSummary
A brief version of a patient's condition.
Nested Schema : ConditionSummary
A brief version of a patient's condition.
Match All
A brief version of a patient's condition.
A brief version of a patient's condition.
Show Source
-
allOf
ConditionBase
A base model object with common properties in a condition.
-
object
ConditionSummary-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 : ConditionSummary-allOf[1]
Type:
Show Source
object-
mostRecentComment:
object Comment
Comment details
-
priority:
integer(int64)
The priority value of
this visitconditions. These priority values are guaranteed to be unique (in-order) and contiguous without any gaps or duplicates. The condition with the lowest integer value should be treated as the one with the highest priority. If a condition is not prioritized, then this field is not populated. -
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 : 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 : 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 : 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.
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.