---
title: "Get Site On Shift"
method: GET
path: "/scheduling/on-shift"
tags: ["scheduling"]
---

# Get Site On Shift

`GET /scheduling/on-shift`

## Request

- Base URL: `https://api.verdun.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.verdun.ai/scheduling/on-shift`
- Auth: HTTP bearer

## Query parameters

- `site_id` string, uuid, required

## Response `200`

Successful Response

- GetSiteOnShiftResponse
  - `site_id` string, uuid, required: The site asked about.
  - `as_of` string, date-time, required: The instant the roster was resolved for.
  - `group_id` string, uuid, nullable: The site's coverage group (null when no group covers it).
  - `group_name` string, nullable: Display name of that group.
  - `scheduled` OnShiftOperatorModel[], required: Everyone seated on a shift of the site's coverage group running now, primary first. Empty when no group covers the site or nobody is scheduled.
    - `operator_id` string, uuid, required: The operator ID.
    - `name` string, required: Display name.
    - `primary` boolean, required: Seat 0 of the most-recently-started shift running now on this site's coverage group - the operator who bears a miss.
    - `clocked_in` boolean, required: Has an open time-clock punch right now.
    - `clocked_in_at` string, date-time, nullable: When the open punch started (null when not clocked in).
  - `also_clocked_in` OnShiftOperatorModel[], required: Operators clocked in now who are NOT scheduled on this site (punches older than 24h are treated as forgotten and left out).
    - `operator_id` string, uuid, required: The operator ID.
    - `name` string, required: Display name.
    - `primary` boolean, required: Seat 0 of the most-recently-started shift running now on this site's coverage group - the operator who bears a miss.
    - `clocked_in` boolean, required: Has an open time-clock punch right now.
    - `clocked_in_at` string, date-time, nullable: When the open punch started (null when not clocked in).

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verdun/apis/verdun-api.md) - [All operations](https://skmtc.dev/verdun/apis/verdun-api/llms.txt) - [OpenAPI document](https://skmtc.dev/verdun/apis/verdun-api/revisions/35a2a6ebedda?raw)