---
schema_version: "1"
id: 289cf89925abd02b6283062824d975ce55f5a1630cd21d8471f33a6cfea7f50b
title: Get Service Territories
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/service-cloud/salesforce-scheduler-dev-guide/guides/salesforce-scheduler/uc1-get-service-territory.md
canonical_url: https://developer.salesforce.com/docs/service/salesforce-scheduler-dev-guide/guide/uc1-get-service-territory.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 8cca909d51760699b492eebaec1c7bc935b294e123699ef36d9fc645b2863de7
products:
  - Salesforce Scheduler Developer Guide
  - Service Cloud Developer Content
---

# Get Service Territories

A service territory represents a branch or office location where your service resources (appointment attendees) operate from or meet customers. Show your users your available service territories on the next page on your website by retrieving a list of active service territories from your Salesforce instance. Your users can search for service territories based on user-entered name, city, postal code, or state. Users can also view the distance between two locations, such as between a service territory and the user's current location.

1.  Create a page for users to search for service territories.

    Here’s how a Select Service Territory page can look.

    ![A representation of the Select Service Territory screen.](https://developer.salesforce.com/media/salesforce-scheduler-dev-guide/concurrent-serviceTerritory.png)

2.  To retrieve a list of active service territories from your Salesforce instance, use the `service-territories` Connect API request.

    **Sample Request**

    This sample REST API call uses the [`service-territories`](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_service_territories.htm) request to retrieve service territories within a range of 10 miles from your current location. The default value is 5 miles.

    ```nolang
    https://YOUR_INSTANCE.salesforce.com/services/data/v68.0/connect/scheduling​​​/service-territories?workTypeGroupId=0VSS700000000sVOAQ
    ```

    Where `YOUR_INSTANCE` is a variable.

    **Sample Response**

    The request returns the service territory records.

    ```nolang
    
    {
      "result": {
        "serviceTerritories": [
          {
            "city": "Charlotte",
            "country": "United States",
            "id": "0HhS700000001DYKAY",
            "name": "Spear Street Branch",
            "operatingHoursId": "0OHS700000001HlOAI",
            "postalCode": "05445",
            "state": "VT",
            "street": "121 Spear Street"
          }
        ]
      }
    }
    ```

3.  Parse the JSON response, and show the available service territories on a page that you created.


Your users can select a service territory for the appointment from the page.