API Name: get-health-plan


This API allows request the latest or selected Health Plan for the resident.

Specification


Endpoint [baseurl]/CarePlan/$get-health-plan
Protocol HTTPS
HTTP Method POST
HTTP Header Content-Type: application/fhir+json
Pagination No
Target System Consumer / Provider Apps

API Spec

This operation does NOT change content

Parameters (In)

NameCardinalityTypeDocumentation
patient-nric1..1string

NRIC - Patient's identifier.

hci-code0..1string

Institution Healthcare Code. Optional for consumer app and NEHR, mandatory for provider app.

_id0..1string

Unique id of the health plan.

_x-versionid0..1integer

Version of the health plan.

Return Values (Out)

NameCardinalityTypeDocumentation
return1..1CarePlan

Return the latest or selected health plan.

Request Body

Remarks:

  • (All Slices) is an automatically generated section and should be ignored. Do not pass this as an input parameter. It will also not be part of response.
idΣ0..0id
metaΣ0..1Meta
implicitRulesΣ ?!0..0uri
language0..0codeBinding
id0..1id
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
nameΣ1..1string
valueAddressAddress
valueAgeAge
valueAnnotationAnnotation
valueAttachmentAttachment
valueBase64Binarybase64Binary
valueBooleanboolean
valueCanonicalcanonical
valueCodecode
valueCodeableConceptCodeableConcept
valueCodingCoding
valueContactDetailContactDetail
valueContactPointContactPoint
valueContributorContributor
valueCountCount
valueDataRequirementDataRequirement
valueDatedate
valueDateTimedateTime
valueDecimaldecimal
valueDistanceDistance
valueDosageDosage
valueDurationDuration
valueExpressionExpression
valueHumanNameHumanName
valueIdid
valueIdentifierIdentifier
valueInstantinstant
valueIntegerinteger
valueMarkdownmarkdown
valueMetaMeta
valueMoneyMoney
valueOidoid
valueParameterDefinitionParameterDefinition
valuePeriodPeriod
valuePositiveIntpositiveInt
valueQuantityQuantity
valueRangeRange
valueRatioRatio
valueReferenceReference
valueRelatedArtifactRelatedArtifact
valueSampledDataSampledData
valueSignatureSignature
valueStringstring
valueTimetime
valueTimingTiming
valueTriggerDefinitionTriggerDefinition
valueUnsignedIntunsignedInt
valueUriuri
valueUrlurl
valueUsageContextUsageContext
valueUuiduuid
resourceΣ C0..1Resource
partΣ0..*see (parameter)
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
nameΣ1..1string
valueStringstring
resourceΣ C0..0Resource
partΣ0..0see (parameter)
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
nameΣ1..1string
valueStringstring
resourceΣ C0..0Resource
partΣ0..0see (parameter)
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
nameΣ1..1string
valueStringstring
resourceΣ C0..0Resource
partΣ0..0see (parameter)
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
nameΣ1..1string
valueStringstring
resourceΣ C0..0Resource
partΣ0..0see (parameter)




Response Body Spec

Note:

  • The "subject" element is a mandatory field in the FHIR Goal resource, and its cardinality (1..1) cannot be modified. This field will be populated automatically by the HSAR backend, and returned
  • Additional element 'id' will be returned under Goal resource
  • For the detailed structures of detailQuantity, detailRatio, dueDate, and dueDuration within the Goal resource, please refer to the profile link for full specifications.
idΣ1..1id
id0..0id
extensionC0..0Extension
versionIdΣ1..1id
lastUpdatedΣ1..1instant
sourceΣ0..0uri
profileΣ0..0canonical(StructureDefinition)
securityΣ0..0CodingBinding
id0..0id
extensionC0..0Extension
systemΣ1..1uri
versionΣ0..0string
codeΣ1..1code
displayΣ0..0string
userSelectedΣ0..0boolean
implicitRulesΣ ?!0..0uri
language0..0codeBinding
text0..0Narrative
GoalC0..*profile-HealthPlan-get-health-plan-goal
ConditionC0..*profile-HealthPlan-conditionBase
id0..0id
extensionC0..0Extension
url1..1uriFixed Value
id0..0id
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
id0..0id
extensionC0..0Extension
url1..1uriFixed Value
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
id0..0id
extensionC0..0Extension
url1..1uriFixed Value
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
modifierExtension?! C0..0Extension
identifierΣ0..0Identifier
instantiatesCanonicalΣ0..0canonical(ActivityDefinition | Measure | OperationDefinition | PlanDefinition | Questionnaire)
instantiatesUriΣ0..0uri
basedOnΣ C0..0Reference(CarePlan)
replacesΣ C0..0Reference(CarePlan)
partOfΣ C0..0Reference(CarePlan)
statusΣ ?!1..1codeBindingFixed Value
intentΣ ?!1..1codeBindingFixed Value
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1codeFixed Value
displayΣ0..1stringFixed Value
userSelectedΣ0..0boolean
textΣ0..0string
titleΣ0..0string
descriptionΣ0..0string
id0..0id
extensionC0..0Extension
referenceΣ C1..1string
typeΣ1..1uriBindingFixed Value
displayΣ0..0string
encounterΣ C0..0Reference(Encounter)
id0..0id
extensionC0..0Extension
startΣ C1..1dateTime
endΣ C0..1dateTime
createdΣ1..1dateTime
id0..0id
extensionC0..0Extension
referenceΣ C0..1string
typeΣ1..1uriBindingFixed Value
id0..0id
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
displayΣ0..1string
contributorC0..0Reference(CareTeam | Device | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
careTeamC0..0Reference(CareTeam)
id0..0id
extensionC0..0Extension
referenceΣ C1..1string
typeΣ0..0uriBinding
identifierΣ0..0Identifier
displayΣ0..0string
supportingInfoC0..0Reference(Resource)
id0..0id
extensionC0..0Extension
referenceΣ C1..1string
typeΣ0..0uriBinding
identifierΣ0..0Identifier
displayΣ0..0string
id0..1id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
outcomeCodeableConcept0..*CodeableConcept
outcomeReferenceC0..0Reference(Resource)
progress0..0Annotation
referenceC0..0Reference(Appointment | CommunicationRequest | DeviceRequest | MedicationRequest | NutritionOrder | RequestGroup | ServiceRequest | Task | VisionPrescription)
id0..1id
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
kind0..1codeBinding
instantiatesCanonical0..*canonical(ActivityDefinition | Measure | OperationDefinition | PlanDefinition | Questionnaire)
instantiatesUri0..*uri
code0..1CodeableConcept
reasonCode0..*CodeableConcept
reasonReferenceC0..*Reference(Condition | DiagnosticReport | DocumentReference | Observation)
goalC0..*Reference(Goal)
status?!1..1codeBinding
statusReason0..1CodeableConcept
doNotPerform?!0..1boolean
scheduledPeriodPeriod
scheduledStringstring
scheduledTimingTiming
locationC0..1Reference(Location)
performerC0..*Reference(CareTeam | Device | HealthcareService | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
productCodeableConceptCodeableConcept
productReferenceReference(Medication | Substance)
dailyAmountC0..1SimpleQuantity
quantityC0..1SimpleQuantity
description0..1string
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
outcomeCodeableConcept0..0CodeableConcept
outcomeReferenceC0..0Reference(Resource)
progress0..0Annotation
referenceC0..0Reference(Appointment | CommunicationRequest | DeviceRequest | MedicationRequest | NutritionOrder | RequestGroup | ServiceRequest | Task | VisionPrescription)
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
kind1..1codeBindingFixed Value
instantiatesCanonical0..0canonical(ActivityDefinition | Measure | OperationDefinition | PlanDefinition | Questionnaire)
instantiatesUri0..0uri
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
reasonCode0..0CodeableConcept
reasonReferenceC0..0Reference(Condition | DiagnosticReport | DocumentReference | Observation)
goalC0..0Reference(Goal)
status?!1..1codeBindingFixed Value
statusReason0..0CodeableConcept
doNotPerform?!0..0boolean
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
eventΣ C1..1dateTime
codeΣ0..0CodeableConceptBinding
locationC0..0Reference(Location)
performerC0..0Reference(CareTeam | Device | HealthcareService | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
dailyAmountC0..0SimpleQuantity
quantityC0..0SimpleQuantity
description0..0string
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1codeFixed Value
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
outcomeReferenceC0..0Reference(Resource)
progress0..0Annotation
referenceC0..0Reference(Appointment | CommunicationRequest | DeviceRequest | MedicationRequest | NutritionOrder | RequestGroup | ServiceRequest | Task | VisionPrescription)
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
kind1..1codeBindingFixed Value
instantiatesCanonical0..0canonical(ActivityDefinition | Measure | OperationDefinition | PlanDefinition | Questionnaire)
instantiatesUri0..0uri
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ C1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
reasonCode0..0CodeableConcept
reasonReferenceC0..0Reference(Condition | DiagnosticReport | DocumentReference | Observation)
goalC0..0Reference(Goal)
status?!1..1codeBindingFixed Value
statusReason0..0CodeableConcept
doNotPerform?!0..0boolean
locationC0..0Reference(Location)
performerC0..0Reference(CareTeam | Device | HealthcareService | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
dailyAmountC0..0SimpleQuantity
quantityC0..0SimpleQuantity
description0..1string
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1codeFixed Value
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
outcomeReferenceC0..0Reference(Resource)
progress0..0Annotation
referenceC0..0Reference(Appointment | CommunicationRequest | DeviceRequest | MedicationRequest | NutritionOrder | RequestGroup | ServiceRequest | Task | VisionPrescription)
id0..0id
id0..0id
extensionC0..0Extension
url1..1uriFixed Value
valueDatedate
modifierExtensionΣ ?! C0..0Extension
kind1..1codeBindingFixed Value
instantiatesCanonical0..0canonical(ActivityDefinition | Measure | OperationDefinition | PlanDefinition | Questionnaire)
instantiatesUri0..0uri
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ C1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
reasonCode0..0CodeableConcept
reasonReferenceC0..0Reference(Condition | DiagnosticReport | DocumentReference | Observation)
goalC0..0Reference(Goal)
status?!1..1codeBindingFixed Value
statusReason0..0CodeableConcept
doNotPerform?!0..0boolean
scheduledPeriodPeriod
scheduledStringstring
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
eventΣ0..0dateTime
id0..0id
extensionC0..0Extension
countΣ0..0positiveInt
countMaxΣ0..0positiveInt
durationΣ0..0decimal
durationMaxΣ0..0decimal
durationUnitΣ0..0codeBinding
frequencyΣ1..1positiveIntFixed Value
frequencyMaxΣ0..0positiveInt
periodΣ1..1decimalFixed Value
periodMaxΣ0..0decimal
periodUnitΣ1..1codeBindingFixed Value
dayOfWeekΣ0..0codeBinding
timeOfDayΣ0..0time
whenΣ0..0codeBinding
offsetΣ0..0unsignedInt
codeΣ0..0CodeableConceptBinding
locationC0..0Reference(Location)
performerC0..0Reference(CareTeam | Device | HealthcareService | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
dailyAmountC0..0SimpleQuantity
quantityC0..0SimpleQuantity
description0..1string
id0..0id
noteExtensionC1..1Extension(CodeableConcept)
timeΣ0..0dateTime
textΣ C1..1markdown

idΣ1..1id
id0..0id
extensionC0..0Extension
versionIdΣ0..0id
lastUpdatedΣ0..0instant
sourceΣ0..0uri
profileΣ1..1canonical(StructureDefinition)
securityΣ0..0CodingBinding
tagΣ0..0Coding
implicitRulesΣ ?!0..0uri
language0..0codeBinding
text0..0Narrative
containedC0..0Resource
extensionC0..0Extension
modifierExtension?! C0..0Extension
identifier0..0Identifier
lifecycleStatusΣ ?!1..1codeBinding
achievementStatusΣ0..0CodeableConceptBinding
categoryΣ0..0CodeableConcept
priorityΣ0..0CodeableConceptBinding
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
id0..0id
extensionC0..0Extension
referenceΣ C1..1string
typeΣ0..0uriBinding
identifierΣ0..0Identifier
displayΣ0..0string
id0..0id
id0..0id
extensionC0..0Extension
url1..1uriFixed Value
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
modifierExtensionΣ ?! C0..0Extension
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..1string
detailQuantityprofile-HealthPlan-health-plan-valueQuantity
detailRatioprofile-HealthPlan-health-plan-valueRatio
dueDateprofile-HealthPlan-health-plan-valueDate
dueDurationprofile-HealthPlan-health-plan-valueDuration
statusDateΣ0..0date
statusReason0..0string
expressedByΣ C0..0Reference(Patient | Practitioner | PractitionerRole | RelatedPerson)
addressesC0..0Reference(Condition | MedicationStatement | NutritionOrder | Observation | RiskAssessment | ServiceRequest)
note0..0Annotation
outcomeCode0..0CodeableConcept
outcomeReferenceC0..0Reference(Observation)

idΣ1..1id
metaΣ0..1Meta
implicitRulesΣ ?!0..0uri
language0..0codeBinding
text0..0Narrative
containedC0..0Resource
extensionC0..0Extension
modifierExtension?! C0..0Extension
identifierΣ0..0Identifier
clinicalStatusΣ ?! C0..0CodeableConceptBinding
verificationStatusΣ ?! C0..0CodeableConceptBinding
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
severity0..0CodeableConceptBinding
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
bodySiteΣ0..0CodeableConcept
subjectΣ C1..1Reference(Group | Patient)
encounterΣ C0..0Reference(Encounter)
recordedDateΣ0..0dateTime
recorderΣ C0..0Reference(Patient | Practitioner | PractitionerRole | RelatedPerson)
asserterΣ C0..0Reference(Patient | Practitioner | PractitionerRole | RelatedPerson)
note0..0Annotation

Error Response

Click here for General API Error Handling

Custom Error Codes

Refer to Custom Error Codes for the list of custom error codes specific to this API.