CareRequest

Represents the general details of a care-related request including member information, admission date, decision reason, and so on. A single request can contain multiple diagnoses, services, or drugs. Care requests include preauthorizations for drugs and services, admission notifications, concurrent review of admissions, appeals, complaints, and grievances.

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date and time when an acknowledgment letter was sent to the requester.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Actual admission date for the patient.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Actual discharge date for the patient.

• Type: textarea
• Properties: Create, Nillable, Update
• Description: Notes related to the admission.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Where the patient was admitted from, for example, a clinic or an emergency room.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Type of admission, for example, emergency or elective.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date and time when the Appointment of Representative (AOR) form was received.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date and time when the AOR form was requested.

• Type: picklist

• Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update

• Description: The type of reason associated with the appeal request.

• Possible values:

  • Service Request Rejected
  • Service Claim Unpaid
  • Rejected - Service Not Required
  • Rejected - No Coverage Benefit
  • Notification Delayed
  • Specialist Referral Rejected

• Type: reference

• Properties: Create, Filter, Group, Nillable, Sort, Update

• Description: ID of the appointed representative for the member.

  This is a relationship field.

• Relationship Name: AppointedRepresentative

• Relationship Type: Lookup

• Refers To: Account

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date and time of verbal contact with the member’s appointed representative.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date and time correspondence was sent to the member’s appointed representative.

• Type: int
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Approved number of days for the admission.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Approved level of care for the patient, for example, Hospital-Observaton or SNF-Rehabilitation.

• Type: reference

• Properties: Create, Filter, Group, Sort

• Description: Case related to the care request.

  A case record can only be related to a single care request record. Therefore, ensure that the Case record you specify in this field isn’t already associated with another care request.

  Note

  This is a relationship field.

• Relationship Name: CareRequestCase

• Relationship Type: Lookup

• Refers To: Case

• Type: string
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Claim number for the medical service or medication, if one exists.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Clinical case type for the patient, for example, High Risk Fall or Adult Diabetes.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Indicates whether criteria for care was met.

• Type: int
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Total number of days for the admission.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Level of care that the patient is receiving.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date by which the decision must be made for the request.

• Type: int
• Properties: Filter, Group, Nillable, Sort
• Description: Number of days remaining for a decision or resolution.

• Type: textarea
• Properties: Create, Nillable, Update
• Description: The text of the determination letter sent to the member and provider.

• Type: textarea
• Properties: Create, Nillable, Update
• Description: Notes related to the decision.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Reason for the decision.

• Type: textarea
• Properties: Create, Nillable, Update
• Description: Text describing the reason for the decision.

• Type: int
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Number of days denied for the admission.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Level of care denied for the patient.

• Type: textarea
• Properties: Create, Nillable, Update
• Description: Notes related to the disposition of the request.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date the request is due for completion.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: The start date for an effective-date range.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: The end date for an effective-date range.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Expiration date for the request.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date and time an extension was requested.

• Type: string
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Complaint ID number.

• Type: string
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: The medical record number used to identify a patient.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Type of facility bed for the patient.

• Type: string
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: The facility room number for the patient.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Final level of care the patient.

• Type: reference

• Properties: Create, Filter, Group, Nillable, Sort, Update

• Description: The name of the person who reviewed the request.

  This is a relationship field.

• Relationship Name: FirstReviewer

• Relationship Type: Lookup

• Refers To: User

• Type: textarea
• Properties: Create, Nillable, Update
• Description: Notes from the first reviewer related to the case.

• Type: reference

• Properties: Create, Filter, Group, Nillable, Sort, Update

• Description: Member’s primary or general care practitioner.

  This is a relationship field.

• Relationship Name: GeneralPractitioner

• Relationship Type: Lookup

• Refers To: Contact

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date when the primary care practitioner was verbally notified of the decision

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date when the primary care practitioner was notified of the decision by written correspondence.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Specifies the type of grievance.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date and time when additional information was received from the provider or member.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date and time when additional information was requested from the provider or member.

• Type: date
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Date of initial denial notification.

• Type: time
• Properties: Create, Filter, Nillable, Sort, Update
• Description: The time when the initial care request was denied.

• Type: boolean
• Properties: Create, Defaulted on create, Filter, Group, Sort, Update
• Description: Indicates whether a request was extended.

• Type: boolean
• Properties: Create, Defaulted on create, Filter, Group, Sort, Update
• Description: Indicates whether the care request is for a readmission.
• Default value: false

• Type: boolean
• Properties: Create, Defaulted on create, Filter, Group, Sort, Update
• Description: Indicates whether the member has already received the medial service or medication.

• Type: dateTime
• Properties: Filter, Nillable, Sort
• Description: The timestamp for when the current user last viewed a record related to this record.

• Type: dateTime
• Properties: Filter, Nillable, Sort
• Description: The timestamp for when the current user last viewed this record. If this value is null, it’s possible that this record was referenced (LastReferencedDate) and not viewed.

• Type: reference

• Properties: Create, Filter, Group, Nillable, Sort, Update

• Description: Name of the medical director who reviewed the request.

  This is a relationship field.

• Relationship Name: MedicalDirector

• Relationship Type: Lookup

• Refers To: User

• Type: textarea
• Properties: Create, Nillable, Update
• Description: Notes from the medical director related to the request.

• Type: textarea
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Free-form description of the member’s condition.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date and time when the member was contacted.

• Type: date
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Date of birth of the member.

• Type: string
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: First name of the member.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Gender of the member.

• Type: string
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Insurance group number for the member.

• Type: reference

• Properties: Create, Filter, Group, Nillable, Sort, Update

• Description: Insurance identifier for the member.

  This is a relationship field.

• Relationship Name: Member

• Relationship Type: Lookup

• Refers To: Account

• Type: string
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Insurance identification number for the member.

• Type: string
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Last name of the member.

• Type: reference

• Properties: Create, Filter, Group, Nillable, Sort, Update

• Description: The primary insurance plan of a member associated with the care request when the member is insured under multiple plans.

  This is a relationship field.

• Relationship Name: MemberPrimaryPlan

• Relationship Type: Lookup

• Refers To: MemberPlan

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Indicator of the provider’s prognosis for the member.

• Type: reference

• Properties: Create, Filter, Group, Nillable, Sort, Update

• Description: The secondary insurance plan of a member associated with the care request when the member is insured under multiple plans.

  This is a relationship field.

• Relationship Name: MemberSecondaryPlan

• Relationship Type: Lookup

• Refers To: MemberPlan

• Type: textarea
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: The member’s status at admission, date of outpatient service, or start of care.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date when the member was verbally notified of the decision.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date when the member was notified of the decision by written correspondence.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date the case was modified.

• Type: int
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Modified number of days for the admission.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Modified level of care for the patient.

• Type: string
• Properties: Create, Filter, Group, idLookup, Sort, Update
• Description: Name of the care request.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date the next review is scheduled for completion.

• Type: reference

• Properties: Create, Filter, Group, Nillable, Sort, Update

• Description: The name of the medical director who denied the original request.

  This is a relationship field.

• Relationship Name: OriginalDenialMedicalDirector

• Relationship Type: Lookup

• Refers To: User

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Indicator of whether this provider has entered into an agreement with the insurance carrier.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Place of service for the member’s care such as an inpatient hospital or an ambulatory surgery center.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date and time when the provider was contacted.

• Type: picklist
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Quantity type for the request such as days, units, or visits.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date the request was received.

• Type: date
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: The date when the reconsidered care request was denied.

• Type: time
• Properties: Create, Filter, Nillable, Sort, Update
• Description: The time when the reconsidered care request was denied.

• Type: reference

• Properties: Create, Filter, Group, Nillable, Sort, Update

• Description: The reference care request case number associated with the care request.

  This is a relationship field.

• Relationship Name: ReferenceCareRequestCase

• Relationship Type: Lookup

• Refers To: Case

• Type: string
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Reference authorization number for an appeal, complaint, or grievance.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date the request was reopened.

• Type: picklist

• Properties: Create, Filter, Group, Nillable, Sort, Update

• Description: Reason the request was reopened.

  The possible values are:

  • Administrative Error
  • Original Decision Overturned

• Type: textarea
• Properties: Create, Nillable, Update
• Description: Description of why the request was reopened.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date the request was originally requested.

• Type: int
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Requested number of days for the admission.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Requested level of care for the patient.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Indicates the role of the individual initiating the request.

• Type: reference

• Properties: Create, Filter, Group, Nillable, Sort, Update

• Description: Ordering or referring practitioner for the request.

  This is a relationship field.

• Relationship Name: RequestingPractitioner

• Relationship Type: Lookup

• Refers To: Contact

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: License type of the practitioner.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Specialty of the practitioner, for example, Family Practice or General Surgery.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date when the practitioner was verbally notified of the decision.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date when the practitioner was notified of the decision by written correspondence.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date when the complaint, appeal, or grievance was resolved.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date and time when a resolution letter was sent to the requester.

• Type: textarea
• Properties: Create, Nillable, Update
• Description: Resolution notes for the request.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date the review was completed.

• Type: textarea
• Properties: Create, Nillable, Update
• Description: Field for notes related to the root cause for the request.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Anticipated admission date for the patient.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Scheduled discharge date for the patient.

• Type: date
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Date when patient received the service.

• Type: reference

• Properties: Create, Filter, Group, Nillable, Sort, Update

• Description: Facility where the service is being provided.

  This is a relationship field.

• Relationship Name: ServicingFacility

• Relationship Type: Lookup

• Refers To: Account

• Type: reference

• Properties: Create, Filter, Group, Nillable, Sort, Update

• Description: Practitioner administering the service.

  This is a relationship field.

• Relationship Name: ServicingPractitioner

• Relationship Type: Lookup

• Refers To: Contact

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: License type of the practitioner.

• Type: picklist
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Specialty of the practitioner.

• Type: string
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: System from which this request was sourced.

• Type: string
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: ID of the system from which the request was sourced.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Timestamp of the most recent update from the source system.

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

CareRequestChangeEvent (API version 59.0)

Change events are available for the object.

CareRequestFeed

Feed tracking is available for the object.

CareRequestHistory

History is available for tracked fields of the object.

j

Health Cloud Developer Guide

Health Cloud Data Model

Advanced Therapy Management

Adverse Events

Assessment Generation

Benefits Verification

Care Program Management

Clinical Data Model

Predecessors to Code Sets and Code Set Bundles in Health Cloud

Coverage Requirement Discovery

Crisis Support Center Management

Documentation Templates and Rules

Disease Surveillance

Electronic Signatures

Engagement Interaction

FHIR Subscription

Financial Assistance Program

Health Assessments

Health Insurance

Home Health

Integrated Care Management

Intelligent Appointment Management

Intelligent Document Automation

Intelligent Sales

Medication Management

Patient Program Outcome Management

Participant Management

Patient Segmentation

Pharmacy Benefits Verification

Provider Network Management

Provider Relationship Management

Remote Monitoring and Device Registration

Social Determinants

Timeline

Unified Health Scoring

Utilization Management

CareDiagnosis

CareProcessingError

CareRequest

CareRequestDrug

CareRequestExchangeInfo

CareRequestExtension

CareRequestItem

CareRequestReviewer

CareRequestSupportingCntnt

TrackedCommunication

TrackedCommunicationDetail

ProductRequest

Health Cloud Associated Objects

Health Cloud Fields on Standard Objects

Health Cloud Platform Events

Working With Electronic Health Records

Emergency Response Management

Apex Reference

Health Cloud Business APIs

Health Cloud Tooling API Objects

Health Cloud Standard Invocable Actions

Metadata Types

Health Cloud FHIR APIs

MuleSoft Direct Integrations

API End-of-Life Policy

Health Cloud Managed Package

Previous Versions