---
schema_version: "1"
id: f2bd6fdb9a693a7ac268ff7c70e3573f0185988d2aba7d7638c37f76547747df
title: Get Resources for Manual Scheduling Action
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/health_cloud_object_reference/actions_obj_get_resources_manual_scheduling.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/actions_obj_get_resources_manual_scheduling.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 74464c872e15604769cb1be02a4ea334c4a488f7bb18ec22b283bc552838a078
description: Recommend resources to use when you manually schedule a start of care visit or recurring visits.
---
# Get Resources for Manual Scheduling Action

Recommend resources to use when you manually schedule a start of care visit or recurring visits.

This action is available in API version 61.0 and later.

## Special Access Rules

The Get Resources for Manual Scheduling action is available in Enterprise and Unlimited Editions with Health Cloud enabled with the Home Health setting.

## Supported REST HTTP Methods

**URI**: /services/data/vXX.X/actions/standard/getResourcesForMnlScheduling

Where XX.X is the latest API version.

**Formats**: JSON, XML

**HTTP Methods**: GET

**Authentication**: Authorization: Bearer TOKEN

Where TOKEN is your OAuth access token.

## Inputs

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



          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader  " id="d306476e107">Input</th>

              <th class="featureTableHeader  " id="d306476e110">Type</th>

              <th class="featureTableHeader  " id="d306476e113">Description</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d306476e107" data-title="Input"><span class="keyword parmname">operatingHoursId</span></td>

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

              <td class="entry" headers="d306476e113" data-title="Description">ID of the operating hours record that specifies the
                time slots to schedule a home visit.</td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e107" data-title="Input"><span class="keyword parmname">recurringDaysList</span></td>

              <td class="entry" headers="d306476e110" data-title="Type">List &lt;String&gt;</td>

              <td class="entry" headers="d306476e113" data-title="Description">Comma-delimited list of days to schedule recurring home
                visits. For example, <samp class="codeph nolang">Monday</samp>, <samp class="codeph nolang">Thursday</samp>, and <samp class="codeph nolang">Saturday</samp>. If
                <span class="keyword parmname">recurrenceFrequencyType</span>
                parameter is set to <samp class="codeph nolang">Weekly</samp>, the
                <span class="keyword parmname">recurringDaysList</span> parameter is
                required.
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e107" data-title="Input"><span class="keyword parmname">recurrenceFrequencyCount</span></td>

              <td class="entry" headers="d306476e110" data-title="Type">Integer</td>

              <td class="entry" headers="d306476e113" data-title="Description">
                <p class="p">Number of recurring home visits to be scheduled
                  <samp class="codeph nolang">Weekly</samp> or
                  <samp class="codeph nolang">Daily</samp>, based
                  on the value specified in the
                  <span class="keyword parmname">recurrenceFrequencyType</span>
                  parameter.
                </p>

                <p class="p">When <span class="keyword parmname">recurrenceFrequencyType</span>
                  parameter value is <samp class="codeph nolang">Weekly</samp>, the
                  <span class="keyword parmname">recurrenceFrequencyCount</span>
                  parameter value specifies the number of home visits
                  to schedule per week. When
                  <span class="keyword parmname">recurrenceFrequencyType</span>
                  parameter value is <samp class="codeph nolang">Daily</samp>, the
                  <span class="keyword parmname">recurrenceFrequencyCount</span>
                  parameter value specifies the number of home visits
                  to schedule per day.
                </p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e107" data-title="Input"><span class="keyword parmname">recurrenceFrequencyType</span></td>

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

              <td class="entry" headers="d306476e113" data-title="Description">Required<p class="p">Type of recurring home visits. Valid values are:</p>

                <ul class="ul bulletList">
                  <li class="li"><samp class="codeph nolang">Daily</samp></li>

                  <li class="li"><samp class="codeph nolang">Weekly</samp></li>

                </ul>

                <p class="p">If the value is set to <samp class="codeph nolang">Weekly</samp>, the
                  <span class="keyword parmname">recurringDaysList</span> parameter
                  is required.
                </p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e107" data-title="Input"><span class="keyword parmname">resourceRecommendationCount</span></td>

              <td class="entry" headers="d306476e110" data-title="Type">Integer</td>

              <td class="entry" headers="d306476e113" data-title="Description">Required<p class="p">Maximum number of resource recommendations to be
                  shown to the scheduler.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e107" data-title="Input"><span class="keyword parmname">schedulingPolicyId</span></td>

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

              <td class="entry" headers="d306476e113" data-title="Description">Required<p class="p">ID of the home health scheduling policy to be used to
                  identify care resources available for the home
                  visits.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e107" data-title="Input"><span class="keyword parmname">serviceAppointmentId</span></td>

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

              <td class="entry" headers="d306476e113" data-title="Description">Required<p class="p">ID of a service appointment record that’s used to get
                  the eligible resources for the home visits.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e107" data-title="Input"><span class="keyword parmname">visitsRequired</span></td>

              <td class="entry" headers="d306476e110" data-title="Type">Integer</td>

              <td class="entry" headers="d306476e113" data-title="Description">Required<p class="p">Number of recurring home visits to schedule.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e107" data-title="Input"><span class="keyword parmname">visitType</span></td>

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

              <td class="entry" headers="d306476e113" data-title="Description">Required<p class="p">Type of home visit to fetch the resources for. Valid
                  values are:</p>

                <ul class="ul bulletList">
                  <li class="li"><samp class="codeph nolang">Start of
                      Care</samp></li>

                  <li class="li"><samp class="codeph nolang">Recurring</samp></li>

                </ul>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e107" data-title="Input"><span class="keyword parmname">workTypeId</span></td>

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

              <td class="entry" headers="d306476e113" data-title="Description">ID of the work type record used to get the resources
                for the home visit.</td>

            </tr>

          </tbody>

        </table>

## Outputs

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



          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader  " id="d306476e368">Output</th>

              <th class="featureTableHeader  " id="d306476e371">Type</th>

              <th class="featureTableHeader  " id="d306476e374">Description</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d306476e368" data-title="Output"><span class="keyword parmname">endDateTime</span></td>

              <td class="entry" headers="d306476e371" data-title="Type">Datetime</td>

              <td class="entry" headers="d306476e374" data-title="Description">Scheduled end for the returned slot.</td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e368" data-title="Output"><span class="keyword parmname">grade</span></td>

              <td class="entry" headers="d306476e371" data-title="Type">Integer</td>

              <td class="entry" headers="d306476e374" data-title="Description">Grade for the resource recommendation.</td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e368" data-title="Output"><span class="keyword parmname">manualSchedulingRecommendations</span></td>

              <td class="entry" headers="d306476e371" data-title="Type">JSON</td>

              <td class="entry" headers="d306476e374" data-title="Description">JSON collection of the
                <span class="keyword parmname">resourceRecommendations</span>
                parameter that contains resource details such as
                resource name, resource ID, and their available time
                intervals.
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e368" data-title="Output"><span class="keyword parmname">recommendationGrade</span></td>

              <td class="entry" headers="d306476e371" data-title="Type">Integer</td>

              <td class="entry" headers="d306476e374" data-title="Description">Grade for the resource and slot combination.</td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e368" data-title="Output"><span class="keyword parmname">resourceId</span></td>

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

              <td class="entry" headers="d306476e374" data-title="Description">ID of the selected service resource.</td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e368" data-title="Output"><span class="keyword parmname">resourceName</span></td>

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

              <td class="entry" headers="d306476e374" data-title="Description">Name of the selected service resource.</td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e368" data-title="Output"><span class="keyword parmname">resourceRecommendations</span></td>

              <td class="entry" headers="d306476e371" data-title="Type">JSON</td>

              <td class="entry" headers="d306476e374" data-title="Description">JSON collection for each resource that contains
                resource details such as resource name, resource ID,
                their available time slots, and the grade for the
                resource recommendation.</td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e368" data-title="Output"><span class="keyword parmname">sequence</span></td>

              <td class="entry" headers="d306476e371" data-title="Type">Integer</td>

              <td class="entry" headers="d306476e374" data-title="Description">Sequence of this interval in the returned list of
                resources.</td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e368" data-title="Output"><span class="keyword parmname">startDateTime</span></td>

              <td class="entry" headers="d306476e371" data-title="Type">Datetime</td>

              <td class="entry" headers="d306476e374" data-title="Description">Scheduled start for the returned slot.</td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e368" data-title="Output"><span class="keyword parmname">scheduleIntervalRecommendations</span></td>

              <td class="entry" headers="d306476e371" data-title="Type">JSON</td>

              <td class="entry" headers="d306476e374" data-title="Description">JSON that contains time interval details for the
                recommended resource. The details include start
                date, end date, grade for the time slot, and the
                sequence number in which the service appointment
                gets scheduled.</td>

            </tr>

            <tr>
              <td class="entry" headers="d306476e368" data-title="Output"><span class="keyword parmname">visitType</span></td>

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

              <td class="entry" headers="d306476e374" data-title="Description">
                <p class="p">Type of home visit to fetch the resources for. Valid
                  values are:</p>

                <ul class="ul bulletList">
                  <li class="li"><samp class="codeph nolang">Start of
                      Care</samp></li>

                  <li class="li"><samp class="codeph nolang">Recurring</samp></li>

                </ul>
              </td>

            </tr>

          </tbody>

        </table>

## Example

**GET**

This sample request is for the Get Resources for Manual Scheduling action.

{
    "inputs": \[
        {
            "visitType": "Recurring",
            "schedulingPolicyId": "a0cSGxx0000CD37YAG",
            "workTypeId": "08qSG0000004zBNYxx",
            "recurrenceFrequencyType": "WEEKLY",
            "recurrenceFrequencyCount": 2,
            "visitsRequired": 2,
            "recurringDaysList": "Monday,Tuesday",
            "resourceRecommendationCount": 3,
            "operatingHoursId": "0OHSG00000xxSUH4A4",
            "serviceAppointmentId": "08pSG00000xxUrdYAG"
        }
    \]
}

This sample response is for the Get Resources for Manual Scheduling action.

{
    {
        "visitType": "Recurring",
        "manualSchedulingRecommendations": \[
            {
                "resourceRecommendations": \[
                    {
                        "scheduleIntervalRecommendations": \[
                            {
                                "startDateTime": "2024-08-05T12:59:59.000Z",
                                "sequence": 1,
                                "grade": "100",
                                "endDateTime": "2024-08-05T01:00:00.000Z"
                            },
                            {
                                "startDateTime": "2024-08-06T05:15:00.000Z",
                                "sequence": 2,
                                "grade": "0",
                                "endDateTime": "2024-08-06T02:00:00.000Z"
                            }
                        \],
                        "resourceName": "Allen Smith",
                        "resourceId": "0HnSG00000085yb0xx"
                    }
                \],
                "recommendationGrade": "85"
            }
        \]
    }
}