List Shifts

The shifts endpoint allows you to query for ongoing and completed work performed by an end user. It includes details about shift dates, timestamps, the type of work, and associated earnings. Shifts are returned in reverse chronological order by end_date. This is a paginated endpoint; see how Pinwheel implements pagination <a href='https://docs.pinwheelapi.com/docs/pagination-1' target='_blank'>here</a>.

get/accounts/{account_id}/shifts

Request

Base URL
https://api.getpinwheel.com/v1
Auth
API key in header X-API-SECRET
TypeScript
https://skmtc.dev/getpinwheel/apis/pinwheel/docs/accounts/:account_id/shifts/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

account_idstring uuid required

UUID of the payroll account.

Query parameters

from_start_datestring date

Return shifts where the start_date field is on or after this date. ISO 8601 format.

to_start_datestring date

Return shifts where the start_date field is on or before this date. ISO 8601 format.

from_end_datestring date

Return shifts where the end_date field is on or after this date. ISO 8601 format.

to_end_datestring date

Return shifts where the end_date field is on or before this date. ISO 8601 format.

limitinteger

The maximum number of results to return.

cursorstring

Cursor for the page you want to retrieve.

Headers

Pinwheel-Version'2025-07-08' | '2023-11-22' | '2023-07-18' | '2023-04-18' | '2022-09-09' | '2022-06-22' | '2022-03-02' required

Version identifier specifying how the Pinwheel API should behave. See the Change Management page for more information.

Response

Changes

No recorded changes to this operation across all 14 revisions of this API.