---
schema_version: "1"
id: 74f6402a2816c3a2f0844a269daa74db0e7184e75473b6e27a5041b1482a4f0d
title: Care Services Review Resources
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/health_cloud_object_reference/hc_resource_care_services_review.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_resource_care_services_review.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 4a83f10528a26e2cb681db048abbd5f31d1ee50526884e0efef5488d3ea32f5f
description: Use these resources to create or update care services review requests, or get information about the status of existing requests.Get details of existing care services review requests.Create care services review requests or update existing requests.Update care services review requests or update existing requests.
---
# Care Services Review Resources

Use these resources to create or update care services review requests, or get information about the status of existing requests.

Available resources:

| Resource | Description |
| --- | --- |
| [/services/data/vXX.X/connect/health/care-services](https://developer.salesforce.com/docs/atlas.en-us.264.0.health_cloud_object_reference.meta/health_cloud_object_reference/hc_resource_care_services_review.htm#connect_resources_create_care_services_review) | Create care services review requests. |
| [/services/data/vXX.X/connect/health/care-services](#connect_resources_create_update_care_services_review "Update care services review requests or update existing requests.") | Update existing care services review requests. |
| [/services/data/vXX.X/connect/health/care-services/{ids}](#connect_resources_get_care_services "Get details of existing care services review requests.") | Get details of existing care services review requests. Replace {ids} with a semicolon-separated list of IDs. |

## Care Services Review Requests (GET)

Get details of existing care services review requests.

### Resource

/services/data/vXX.X/connect/health/care-services/{ids}

Replace {ids} with a semicolon-separated list of IDs. The items in this list can be Salesforce ID, or a SourceSystemIdentifier. Use idName query parameter to specify the type of {ids} provided in the URI.

URI Example to retrieve care requests using Salesforce IDs:

/connect/health/care-services/0Uk7859783498540;0Uk6712899900;0Um4367564378788?idName=Id&sectionNames=Subscriber;CareRequest

![Important](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/images/icon_note_important.png)

#### Important

Ensure that semicolon character is not a part of any id, if using SourceSystemIdentifier to retrieve care requests.

### Available version

46.0

### Authentication

Use OAuth to connect to Salesforce and get an access token. Pass the access token in your requests. For more information, see [Connect to Connect REST API Using OAuth](https://developer.salesforce.com/docs/atlas.en-us.264.0.chatterapi.meta/chatterapi/quickstart_connecting.htm "HTML (New Window)").

### HTTP methods

GET

### Query parameters

<table class="featureTable sort_table" summary="">





              <thead class="thead sorted" align="left">
                <tr>
                  <th class="featureTableHeader vertical-align-top " id="d604627e238">Parameter Name</th>

                  <th class="featureTableHeader vertical-align-top " id="d604627e241">Type</th>

                  <th class="featureTableHeader vertical-align-top " id="d604627e244">Description</th>

                  <th class="featureTableHeader vertical-align-top " id="d604627e247">Required</th>

                  <th class="featureTableHeader vertical-align-top " id="d604627e250">Available Version</th>

                </tr>

              </thead>

              <tbody class="tbody">
                <tr>
                  <td class="entry" headers="d604627e238" data-title="Parameter Name"><samp class="codeph nolang">idName</samp></td>

                  <td class="entry" headers="d604627e241" data-title="Type">String</td>

                  <td class="entry" headers="d604627e244" data-title="Description">Indicates the type of identifiers used in the path parameter
                    <span class="keyword parmname">ids</span>. The valid values are:<ul class="ul bulletList">
                      <li class="li">
                        <samp class="codeph nolang">id</samp>: Salesforce object ID.
                      </li>

                      <li class="li">
                        <samp class="codeph nolang">SourceSystemIdentifier</samp>: ID of the
                        external system.
                      </li>

                    </ul>
                  </td>

                  <td class="entry" headers="d604627e247" data-title="Required">Yes</td>

                  <td class="entry" headers="d604627e250" data-title="Available Version">46.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d604627e238" data-title="Parameter Name"><samp class="codeph nolang">sectionNames</samp></td>

                  <td class="entry" headers="d604627e241" data-title="Type">String</td>

                  <td class="entry" headers="d604627e244" data-title="Description">Semicolon separated list of section names for which data is requested.
                    For example, <samp class="codeph nolang">Subscriber, Patient, CareDiagnoses,
                      CareRequestItems, CareRequestDrugs, TransportLocations,
                      CareRequest</samp>, or <samp class="codeph nolang">CareRequestCase</samp>.</td>

                  <td class="entry" headers="d604627e247" data-title="Required">No</td>

                  <td class="entry" headers="d604627e250" data-title="Available Version">46.0</td>

                </tr>

              </tbody>

            </table>

### Response body for GET

[Care Authorization Request Get Result](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/connect_responses_care_authorization_request_get_result.htm "The response body for the Care Services Review GET request.")

## Care Services Review Requests (POST)

Create care services review requests or update existing requests.

- You must have Person Accounts enabled to use these APIs.
- After enabling person accounts, enable name suffixes.
    1. Navigate to **Setup** | **Customize** | **User Interface**.
    2. In **Name Settings**, select **Enable Name Suffixes for Person Names** and save.
- You can create or update up to 25 care services requests.

### Resource

/services/data/vXX.X/connect/health/care-services

### Available version

46.0

### Authentication

Use OAuth to connect to Salesforce and get an access token. Pass the access token in your requests.

### HTTP methods

POST

### Request body for POST

**Properties**

| Name | Type | Description | Required | Available Version |
| --- | --- | --- | --- | --- |
| careRequestsList | [Care Authorization Request Input](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/connect_requests_care_authorization_request_input.htm "A complete care authorization request.")\[\] | List of Care Requests to be created or updated. (Up to 25 items.) | Yes | 46.0 |

**JSON Schema**

{
  "careRequestsList": \[
    {
      "careRequestCase": {
        "caseOrigin": "Web"
      },
      "careRequest": {
        "recordType": "Admission",
        "authorizationRefIdentifier": "1234",
        "name": "Headache",
        "member": "001RM000005XHdbYAG",
        "memberPrimaryPlan": "0SqRM00000000Fp0AI",
        "caseSubStatus": "active",
        "servicingFacility": {
          "npi": "742963",
          "servicingFacilityId": "0klRM0000004CBnYAM"
        },
        "requestingPractitioner": {
          "npi": "11111",
          "healthCareProviderId": "0cmRM0000000tldYAA"
        }
      },
      "careRequestItems": \[
        {
          "authApprovalIdentifier": "123",
          "authorizationRefIdentifier": "123",
          "name": "CRI Connect-1.0",
          "procedureCodeSet": "0hxxG0000008hKxxAI",
          "requestType": "Order",
          "priority": "Stat",
          "healthcareProcedureCode": "0XSxx000000SXxxA2",
          "reasonCode": "0hsRM00000003ytYAA",
          "servicingFacility": {
            "npi": "742963",
            "servicingFacilityId": "0klRM0000004CBnYAM"
          },
          "servicingProvider": {
            "npi": "11111",
            "healthCareProviderId": "0cmRM0000000tldYAA"
          },
          "clinicalServiceRequestId": "0jyRM0000004CAGYA2"
        }
      \],
      "careDiagnoses": \[
        {
          "name": "CD Connect 1.0",
          "presentOnAdmission": "Yes",
          "diagnosisCodeSet": "0hsSG0000008hKjYAI",
          "healthcareDiagnosisCode": "0XNSG0000000PjB4AU",
          "healthConditionId": "0j4RM0000004Mk9YAE"
        }
      \],
      "careRequestDrugs": \[
        {
          "name": "CRD Connect 1.0",
          "status": "Active",
          "statusReason": "Insufficient Information",
          "requestType": "Filler Order",
          "drugAdministrationSetting": "Inpatient",
          "priority": "Routine",
          "medicationRefObjectId": "0kmRM0000004CSeYAM",
          "authApprovalIdentifier": "123",
          "authorizationRefIdentifier": "123",
          "servicingFacility": {
            "npi": "742963",
            "servicingFacilityId": "0klRM0000004CBnYAM"
          },
          "servicingProvider": {
            "npi": "11111",
            "healthCareProviderId": "0cmRM0000000tldYAA"
          }
        }
      \],
      "assessmentLinks": \[
          {
            "id": "0U3SG00000068Cb0AI"     
          },
      "patient": {
        "memberId": "001RM000005XHdbYAG",
        "lastName": "Green",
        "firstName": "Charles",
        "birthDate": "2001-10-26T21:32:52"
      }
    }
  \]
}

**Root XML tag:** <careRequestsList>

### Response body for POST

[Care Authorization Request Result](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/connect_responses_care_authorization_request_result.htm "Response to create or update care services review request.")

## Care Services Review Requests (PATCH)

Update care services review requests or update existing requests.

- You must have Person Accounts enabled to use these APIs.
- After enabling person accounts, enable name suffixes.
    1. Navigate to **Setup** | **Customize** | **User Interface**.
    2. In **Name Settings**, select **Enable Name Suffixes for Person Names** and save.
- For PATCH, if the request body contains IDs for CareRequestitem, CareRequestDrug, or CareDiagnosis, then the corresponding records are updated, else the new child records are created.

### Resource

/services/data/vXX.X/connect/health/care-services

### Available version

46.0

### Authentication

Use OAuth to connect to Salesforce and get an access token. Pass the access token in your requests.

### HTTP methods

PATCH

### Request body for PATCH

[Care Requests Update List Input](https://developer.salesforce.com/docs/atlas.en-us.264.0.health_cloud_object_reference.meta/health_cloud_object_reference/connect_requests_care_request_list_update_input.htm)

### Response body for PATCH

[Care Authorization Request Result](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/connect_responses_care_authorization_request_result.htm "Response to create or update care services review request.")

#### See Also

- [_Salesforce Help_: Enable Person Accounts](https://help.salesforce.com/articleView?id=account_person_enable.htm&language=en_US "Salesforce Help: Enable Person Accounts - HTML (New Window)")
- [Connect to Connect REST API Using OAuth](https://developer.salesforce.com/docs/atlas.en-us.264.0.chatterapi.meta/chatterapi/quickstart_connecting.htm)