NAnash
Shifts

Get all shifts

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

  • Base URL
    https://api.sandbox.usenash.com
  • Auth
    none declared

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

No recorded changes to this operation across all 1 revision of this API.