---
schema_version: "1"
id: f22b5e01ec9a18720139d6820cb742dc5ab7a886156efed8665cd9cc53eefffb
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/uc9-get-service-territories.md
canonical_url: https://developer.salesforce.com/docs/service/salesforce-scheduler-dev-guide/guide/uc9-get-service-territories.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 7e4b10c8c630d22dca58fbcf47e174248794c9684ffec0f51488d8728583b876
products:
  - Salesforce Scheduler Developer Guide
  - Service Cloud Developer Content
---

# Get Service Territories

Display the available service territories on the first screen of your appointment scheduling app.

A service territory represents a branch or office location where your service resources (appointment attendees) operate from or meet customers.

Create a page where you can provide users an option 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)

You can search for service territories based on the user-entered name, city, postal code, or state. You can also calculate the distance between two location values, such as between a service territory and the user's current location.

You can Retrieve records with locations within or outside of a certain radius with distance conditions in the WHERE clause of the query. For more information, see the WHERE clause section in [Location-Based SOQL Queries](https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_soql_geolocate.htm).

1.  Use the `Query()` request on the ServiceTerritory object to retrieve a list of active service territories from your Salesforce org.

    **Sample Request**

    This sample REST API call uses the `Query()` request to retrieve service territories within a range of 1 mile from your current location. Default value is 5 miles.

    For more information on using `Query()` request, see [Execute a SOQL Query](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/dome_query.htm).

    ```nolang
    https://YOUR_INSTANCE.salesforce.com/services/data/vXX.X/query/?q=
    SELECT City,Country,Id,Name,State FROM ServiceTerritory WHERE DISTANCE(Address, GEOLOCATION(17.4358411,78.3467857), 'mi') < 1
    ```

    Where `YOUR_INSTANCE` is a variable.

    **Sample Response**

    The request returns the service territory records.

    ```nolang
    {
      "totalSize": 4,
      "done": true,
      "records": [
        {
          "attributes": {
            "type": "ServiceTerritory",
            "url": "/services/data/v55.0/sobjects/ServiceTerritory/0Hhx000000012oOCAQ"
          },
          "City": "Hyderabad",
          "Country": "India",
          "Id": "0Hhx000000012oOCAQ",
          "Name": "Apollo Hyderabad",
          "State": "TG"
        },
        {
          "attributes": {
            "type": "ServiceTerritory",
            "url": "/services/data/v55.0/sobjects/ServiceTerritory/0Hhx000000012oRCAQ"
          },
          "City": "Nanakaramguda",
          "Country": "India",
          "Id": "0Hhx000000012oRCAQ",
          "Name": "Somewhere",
          "State": "TG"
        },
        {
          "attributes": {
            "type": "ServiceTerritory",
            "url": "/services/data/v55.0/sobjects/ServiceTerritory/0Hhx000000012oQCAQ"
          },
          "City": "Hyderabad",
          "Country": "India",
          "Id": "0Hhx000000012oQCAQ",
          "Name": "Partner Service Territory",
          "State": "TG"
        },
        {
          "attributes": {
            "type": "ServiceTerritory",
            "url": "/services/data/v55.0/sobjects/ServiceTerritory/0Hhx000000012oSCAQ"
          },
          "City": "Hyderabad",
          "Country": "India",
          "Id": "0Hhx000000012oSCAQ",
          "Name": "JPMC Bank, Hyderabad",
          "State": "TG"
        }
      ]
    }
    ```


Parse the JSON response, and show the available service territories on the Select Service Territory page so that the user can select a service territory.

Here’s how the service territories are listed based on the users' search.

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

On the next page in your app, you can show the work type groups.