USusenash
Shifts

Get all shifts

Changed on

List courier shifts with optional filtering by time range and store location. Filter by start_time, end_time, store_location_id, or external_store_location_id.

get/v1/shifts

Request

Query parameters

startTimestring date-time required

The start time of the shifts to list.

Example:2025-05-01T00:00:00Z
endTimestring date-time required

The end time of the shifts to list.

Example:2025-06-01T00:00:00Z
storeLocationIdstring nullable

The store location ID to list shifts for.

externalStoreLocationIdstring nullable

The external store location ID to list shifts for.

Response

OK

idstring required

The ID of the shift.

namestring required

The name of the shift.

plannedStartstring required

The planned start timestamp of the shift.

plannedEndstring required

The planned end timestamp of the shift.

plannedBreakDurationinteger nullable

The planned break duration of the shift.

shiftMetadataobject nullable

The metadata of the shift.

statusstring required

The status of the shift.

storeLocationIdstring nullable

The store location ID of the shift.

externalStoreLocationIdstring nullable

The external store location ID of the shift.

zoneIdsstring[] nullable

The zone IDs of the shift.

externalZoneIdsstring[] nullable

The external zone IDs of the shift.

courierIdstring nullable

The courier ID of the shift.

vehicleIdstring nullable

The vehicle ID of the shift.

createdAtstring required

The creation timestamp of the shift.

updatedAtstring required

The update timestamp of the shift.

Example response

{
  "optimizationParams": {
    "serviceTimeRelativeEfficiency": 1,
    "plannedBreaks": [
      {
        "end": 30,
        "start": 0
      }
    ],
    "departureDelay": 15,
    "shiftEndServiceTimeMinutes": 10
  }
}

Changes

  • e3713837c5c9Revision changes
    • info

      api operation id get_shifts_v1_shifts_get removed and replaced with shifts_v1_get_shifts_route_shifts_get

    • info

      added the optional property // to the response with the status