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 territorieson 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.

  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 request to retrieve service territories within a range of 10 miles from your current location. The default value is 5 miles.

    Where YOUR_INSTANCE is a variable.

    Sample Response

    The request returns the service territory records.

  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.