Get Service Territories

Get a service territory based on the work type group that is selected in the previous step. 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.

Make a GET request on the service-territories Connect API by passing the user-entered search values and the selected work type group ID as the input parameters in the query string. You can also use a combination of the radius, latitude, longitude, sortBy, and sortOrder parameters to filter and sort the service territories.

Resource URI

Sample Request

Here’s a sample GET request with the query string on the service territories Connect API.

Sample Response

The API returns the available service territories based on the passed work type group ID and search criteria.

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 a Select Service Territory page showing the available service territories.

Here’s how the service territory details are displayed when the user selects a service territory.

After you get a work type group and service territory for the appointment, you must get a work type that is associated with both the work type group and service territory you have selected in the previous steps.