---
schema_version: "1"
id: c84de9c9ac3816345755c87bd57c1e76402faa082a268e6e4cf0ca7326d56c7c
title: Get Service Appointment Time Slots
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/service-cloud/field-service-dev/guides/field-service/source-files/actions/actions-obj-getappointmentbookingslots.md
canonical_url: https://developer.salesforce.com/docs/service/field-service-dev/guide/actions-obj-getappointmentbookingslots.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 0b01e4ee367091d5f33d63fe9f6011f54cefe81ced838de4467ab3e992177132
products:
  - Field Service Developer Guide
  - Service Cloud Developer Content
---

# Get Service Appointment Time Slots

Retrieves available service appointment time slots based on the time zone, operating hours, scheduling policy and time zone name parameters.

This action is available in API version 62.0 and later.

## Supported REST HTTP Methods

**URI:** `/services/data/vXX.X/actions/standard/getAppointmentBookingSlots`

Where `XX.X` is the latest API version.

**Formats:** JSON, XML

**HTTP Methods:** POST

**Authentication:** `Authorization: Bearer TOKEN`

Where `TOKEN` is a variable.

## Inputs

|Input|Type|Description|
|-----|----|-----------|
|`serviceAppointmentId`|string|Required. The ID of the service appointment to get available time slots for.|
|`operatingHoursId`|string|Required. The operating hours ID of the appointment to get time slots for.|
|`schedulingPolicyId`|string|Required. The scheduling policy ID of the appointment to get time slots for.|
|`timeZoneName`|string|Required. The name of the time zone to use when searching for and showing time slots.|

## Outputs

|Output|Type|Description|
|------|----|-----------|
|`availableSlots`|string|The available time slots for the service appointment.|

## Example

Sample request body:

```nolang
{
  "inputs" : [{
    "serviceAppointmentId" : "08p000000000001AAA",
    "operatingHoursId" : "0OH000000000001AAA",
    "schedulingPolicyId" : "0Vr000000000001AAA",
    "timeZoneName" : "America/Los_Angeles"
  }]
}
```

Sample response body:

```nolang
{
  "actionName" : "getAppointmentBookingSlots",
  "errors" : null,
  "isSuccess" : true,
  "outputValues" : {
    "availableSlots" : "[{\"startTime\":\"2026-08-28T17:00:00.000Z\",\"endTime\":\"2026-08-28T18:00:00.000Z\"}]"
  }
}
```