REST API
SUPPORTFEEDBACK

[beta] listTechnicianShifts

get
https://api.samsara.com/maintenance/technician-shifts

List shifts ordered by updated time and UUID. ID filters allow up to 100 values each, with OR within and AND across filters. Lists are eventually consistent; reconcile overlapping time windows and deduplicate by ID and version.

Rate limit: 5 requests/sec (learn more about rate limits here).

To use this endpoint, select Read Technician Shifts under the Work Orders category when creating or editing an API token. Learn More.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
ids
array of strings
length ≤ 100

Up to 100 comma-separated shift identifiers.

ids
userIds
array of strings
length ≤ 100

Up to 100 comma-separated user IDs.

userIds
externalTechnicianIds
array of strings
length ≤ 100

Up to 100 comma-separated employee aliases.

externalTechnicianIds
date-time

Inclusive updated-time lower bound.

date-time

Exclusive updated-time upper bound.

string

Cursor from the previous page.

integer
1 to 200

Page size from 1 to 200; defaults to 200.

boolean

Include nonempty shift and technician external-ID maps. Defaults to false.

Responses

Updated about 4 hours ago

Did this page help you?
Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 4 hours ago

Did this page help you?