---
title: "Fetch tour list."
method: GET
path: "/tour/fetch"
tags: ["Disposition|Tour"]
---

# Fetch tour list.

`GET /tour/fetch`

This endpoint enables you to access a list of tours. You may add various filter options to ensure that you
obtain the desired data. The response will provide you with fundamental details about the tour, including a team
reference, the number of orders, and the number of stops.


A tour comprises various stops determined by the addresses of assigned orders. Through an optimization function,
stops are sequenced for optimal efficiency, considering distances and travel times. Stops can be manually
sequenced and calculated or optimized. Tour costs are automatically computed, including any user-adjusted
arrival and departure times, which may result in calculated waiting times for the team. These waiting times are
also factored into the cost calculation.


If you require more detailed information, such as the list of the stops, please make use of the
`/tour/fetch_data` endpoint.

## Query parameters

- `filter[byIds][]` integer[]
- `filter[byDistrict][]` integer[]
- `filter[byTeam][]` integer[]
- `filter[byStatus]` string
- `filter[from]` string
- `filter[to]` string
- `offset` integer
- `limit` integer

## Response `200`

Success Response:

- StandardDispoTourFetchResponse
  - `data` object[] — The list of tours.
    - `id` integer — The internal id of the tour.
    - `startDate` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd
    - `team` string — The name of the team.
    - `teamId` integer — The internal id of the team.
    - `district` string — The name of the district.
    - `districtId` integer — The internal id of the district.
    - `numStops` integer — The amount of stops of the tour.
    - `numOrders` integer — The amount of orders of the tour.
    - `duration` integer — The total duration of the tour.
    - `distance` integer — The total distance of the tour.
    - `status` string — The status of the tour.
  - `offset` integer — Number of skipped records.
  - `totalCount` integer — Total number of available tours. (Only calculated if offset is 0)

---

[API](https://skmtc.net/geocapture/apis/geocapture-api.md) · [All operations](https://skmtc.net/geocapture/apis/geocapture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geocapture/geocapture-api/versions/15839b24c497/schema)