---
title: "Get a shift"
method: GET
path: "/v1/shift/{id}"
tags: ["Shifts"]
---

# Get a shift

`GET /v1/shift/{id}`

Retrieve a single courier shift by ID, including its times, assigned courier, and store location.

## Path parameters

- `id` string, required — Shift ID

## Response `200`

OK

- ShiftResponse — 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.
  - `plannedBreakDuration` integer, nullable — The planned break duration of the shift.
  - `shiftMetadata` object, nullable — The metadata of the shift.
  - `optimizationParams` OptimizationParams — unresolved $ref
  - `status` string, required — The status of the shift.
  - `storeLocationId` string, nullable — The store location ID of the shift.
  - `externalStoreLocationId` string, nullable — The external store location ID of the shift.
  - `zoneIds` string[], nullable — The zone IDs of the shift.
  - `externalZoneIds` string[], nullable — The external zone IDs of the shift.
  - `courierId` string, nullable — The courier ID of the shift.
  - `vehicleId` string, nullable — The vehicle ID of the shift.
  - `createdAt` string, required — The creation timestamp of the shift.
  - `updatedAt` string, required — The update timestamp of the shift.

## Other responses

- `422` — Unprocessable Content

---

[API](https://skmtc.dev/usenash/apis/nash-api.md) · [All operations](https://skmtc.dev/usenash/apis/nash-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usenash/nash-api/revisions/09a23a95889b/schema)