--- title: "Fetch tour details." method: GET path: "/tour/fetch_data" tags: ["Disposition|Tour"] --- # Fetch tour details. `GET /tour/fetch_data` This endpoint is able to provide you with details of a tour like detailed information for all stops and associated tour costs. In addition to that you will recieve the `teamHeadEmployee` and the executing employee. You recieve the id of a tour from the list tour endpoint. The Sub-Stop function in tour planning allows for the division of a single work stop among multiple teams, ensuring efficient task allocation for larger jobs. It involves assigning specific time durations to different teams for a shared job, based on the total estimated time required for the stop. If a stop with substops is removed, all substops are also removed. ## Query parameters - `id` integer, required ## Response `200` Success Response: - StandardDispoTourFetchDataResponse - `data` DispoTourFetchDataResponseDispoTourItem - `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. - `reference` integer — The reference of the tour. - `dispoType` string — The name of the dispo type. - `dispoTypeId` integer — The internal id of the dispoType. - `stops` object[] — The stops of the tour. - `id` integer — The internal id of the stop. - `sequence` integer — The sequence of the stop. - `type` string — The stop type. | Value | Description | |--------------------------|--------------------------------------| | HOME | Home Stop used to identify the start and end of the tour | | ORDER | Use this type for a normal stop with orders | | SUB | Used for sub stops | | TBREAK | Break Stop | | HOTEL | Used for overnight stays | | FUEL | Used for fueling | | LOAD | Used for pickup and delivery orders. | | UNLOAD | Used for pickup and delivery orders. | - `name` string — The name address addition. - `name2` string — The name2 address addition. - `name3` string — The name3 address addition. - `street` string — The street. - `zipCode` string — The zip code. - `city` string — The city. - `countryCode` string — The two-digit ISO 3166 country code. - `provinceCode` string — The province code. - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude. - `contactPersonName` string — The contact person name. - `contactPersonEmail` string — The contact person e-mail. - `contactPersonPhoneNumber` string — The contact person phone number. - `contactPersonMobileNumber` string — The contact person mobile number. - `noteDriver` string — A note for the driver. This info is shown to the driver in his app. - `notePlanner` string — A note for the planner. - `estimatedDrivingDuration` integer — The estimated driving duration in seconds between the previos and this stop. - `estimatedDrivingDistance` integer — The estimated driving distance in meters between the previos and this stop. - `estimatedTollCosts` number — The estimated toll costs between the previos and this stop. - `eta` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `etd` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `ata` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `atd` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `etc` integer — The estimated time in seconds to completion of the stop. - `totalSubEtc` integer — The estimated time in seconds to completion of all sub stops. - `atc` integer — The actual time in seconds to completion of the stop. - `orders` object[] — The orders of the stop. - `id` integer — The internal id of the order. - `reference` string — The customer order number. - `externalReference` string — The internal reference for the order. - `subject` string — The order subject. - `createdAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `project` integer — The id of the project. - `projectReferenceSign` string — The reference sign of the project. - `subStops` object[] — The sub stops of the stop. - `id` integer — The internal id of the sub stop. - `tourId` integer — The internal id of the tour from the sub stop. - `etc` integer — The estimated time in seconds to completion of the sub stop. - `masterStopId` integer — The internal id of the master stop. - `masterTourId` integer — The internal id of the tour from the master stop. - `masterEtc` integer — The internal id of the tour from the master stop. - `startTime` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `endTime` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `costs` DispoTourFetchDataResponseDispoTourCostItem - `distance` integer - `idleDuration` integer - `driveDuration` integer - `workDuration` integer - `breakDuration` integer - `sleepDuration` integer - `benchmarkCosts` integer[] - `totalDriveKmCost` number - `totalDriveTimeCost` number - `totalTollCost` number - `totalWorkTimeCost` number - `totalIdleTimeCost` number - `totalAdditionalCost` number - `totalCost` number - `dates` object[] - `distance` integer - `idleDuration` integer - `driveDuration` integer - `workDuration` integer - `breakDuration` integer - `sleepDuration` integer - `benchmarkCosts` integer[] - `totalDriveKmCost` number - `totalDriveTimeCost` number - `totalTollCost` number - `totalWorkTimeCost` number - `totalIdleTimeCost` number - `totalAdditionalCost` number - `totalCost` number - `date` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd - `teamHeadEmployee` DispoTourFetchDataResponseDispoEmployeeItem - `id` integer — The internal employee ID. - `reference` string — The personal number. (max. 20 characters) - `cardNumber` string — The driver card number. - `importSource` string — External data source from which this employee originates. (max. 16 characters) - `importKey` string — External ID from the respective data source. (max. 64 characters) - `numEmployees` integer — The number of employees of the team. - `employee` DispoTourFetchDataResponseDispoEmployeeItem - `id` integer — The internal employee ID. - `reference` string — The personal number. (max. 20 characters) - `cardNumber` string — The driver card number. - `importSource` string — External data source from which this employee originates. (max. 16 characters) - `importKey` string — External ID from the respective data source. (max. 64 characters) --- [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/869b05603541/schema)