GET
/
v1
/
shifts
Get all shifts
curl --request GET \
  --url https://api.sandbox.usenash.com/v1/shifts
{
  "id": "<string>",
  "name": "<string>",
  "plannedStart": "<string>",
  "plannedEnd": "<string>",
  "plannedBreakDuration": 123,
  "shiftMetadata": {},
  "optimizationParams": {
    "serviceTimeRelativeEfficiency": 1,
    "plannedBreaks": [
      {
        "end": 30,
        "start": 0
      }
    ],
    "departureDelay": 15,
    "vehicleConfig": {
      "key": "value"
    }
  },
  "status": "<string>",
  "storeLocationId": "<string>",
  "externalStoreLocationId": "<string>",
  "zoneIds": [
    "<string>"
  ],
  "externalZoneIds": [
    "<string>"
  ],
  "courierId": "<string>",
  "vehicleId": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Query Parameters

startTime
string<date-time>
required

The start time of the shifts to list.

Example:

"2025-05-01T00:00:00Z"

endTime
string<date-time>
required

The end time of the shifts to list.

Example:

"2025-06-01T00:00:00Z"

storeLocationId
string | null

The store location ID to list shifts for.

externalStoreLocationId
string | null

The external store location ID to list shifts for.

Response

OK

Response for shift.

id
string
required

The ID of the shift.

name
string
required

The name of the shift.

plannedStart
string
required

The planned start timestamp of the shift.

plannedEnd
string
required

The planned end timestamp of the shift.

status
string
required

The status of the shift.

createdAt
string
required

The creation timestamp of the shift.

updatedAt
string
required

The update timestamp of the shift.

plannedBreakDuration
integer | null

The planned break duration of the shift.

shiftMetadata
object | null

The metadata of the shift.

optimizationParams
object | null

The optimization parameters of the shift. Input for creating optimization params.

storeLocationId
string | null

The store location ID of the shift.

externalStoreLocationId
string | null

The external store location ID of the shift.

zoneIds
string[] | null

The zone IDs of the shift.

externalZoneIds
string[] | null

The external zone IDs of the shift.

courierId
string | null

The courier ID of the shift.

vehicleId
string | null

The vehicle ID of the shift.