Sign in

v1

latestOpenAPI 3.0.0Proprietary2026-08-06130577659.7 KB
Disposition|Tour

Create/Update stops for a tour.

This method can be used to create and update tour stops. An attempt is made to find an existing stop based on the given id. If one is found, it will be adjusted. Otherwise, a new stop is created.

To share the tour with the driver after a new stop has been added, it must first be calculated. This is made possible at the /tour/calculate endpoint. To insert the stop at a certain point in the tour, the beforeStopId or afterStopId must be set. To share the tour with the driver, calculate the tour and set the status to READY. The drivers can access the tour details via the orders menu in the geoCapture mobile app.

post/tour/upsert_stop

Request body

dryRunboolean

Simulate the operation. (No records will be created or changed) This Parameter is optional.

Example request

{
  "records": [
    {
      "data": {
        "latLng": [
          52.38127828631681,
          7.594243214018696
        ],
        "fixedArrivalDate": "2015-02-20",
        "fixedArrivalTime": "12:59:21",
        "fixedDepartureDate": "2015-02-20",
        "fixedDepartureTime": "12:59:21"
      }
    }
  ]
}

Response

Success Response:

Example response

{
  "createdStops": [
    {
      "latLng": [
        52.38127828631681,
        7.594243214018696
      ],
      "fixedArrivalDate": "2015-02-20",
      "fixedArrivalTime": "12:59:21",
      "fixedDepartureDate": "2015-02-20",
      "fixedDepartureTime": "12:59:21"
    }
  ],
  "updatedStops": [
    {
      "latLng": [
        52.38127828631681,
        7.594243214018696
      ],
      "fixedArrivalDate": "2015-02-20",
      "fixedArrivalTime": "12:59:21",
      "fixedDepartureDate": "2015-02-20",
      "fixedDepartureTime": "12:59:21"
    }
  ],
  "deletedStops": [
    {
      "latLng": [
        52.38127828631681,
        7.594243214018696
      ],
      "fixedArrivalDate": "2015-02-20",
      "fixedArrivalTime": "12:59:21",
      "fixedDepartureDate": "2015-02-20",
      "fixedDepartureTime": "12:59:21"
    }
  ]
}