---
title: "List shifts"
method: GET
path: "/v2/shifts"
tags: ["Shifts"]
---

# List shifts

`GET /v2/shifts`

List all shifts on the account. Supports pagination.

## Query parameters

- `page` integer
- `per_page` integer
- `query` string

## Response `200`

OK

- object
  - `shifts` Shift[]
    - `name` string — The name of the shift
    - `id` integer, required
    - `description` string — Description of the position
    - `days_of_week` string[], required — The days the shift occurs on
    - `hours` object, required
      - `start_time` integer — The time the shift starts
      - `end_time` integer — The time the shift ends
    - `customer_attributes` CustomerAttribute[], nullable — List of customer attributes for the position
      - `value` string, required — Value of the attribute
      - `type` string, required — Human-readable display name of the attribute
      - `key` string, nullable — Machine-readable identifier for the attribute (e.g. JOB_CODE). Optional — not all endpoints that embed customer_attributes populate this field yet (e.g. openings, locations, and location groups currently return only type and value).

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/fountain/apis/hire-public-api.md) · [All operations](https://skmtc.net/fountain/apis/hire-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fountain/hire-public-api/versions/5f406c0e9462/schema)