[beta] List 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.
<b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
To use this endpoint, select Read Technician Shifts under the Work Orders category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
Request
- Base URLhttps://api.samsara.com
- AuthHTTP bearer
Query parameters
Up to 100 comma-separated shift identifiers.
Up to 100 comma-separated user IDs.
Up to 100 comma-separated employee aliases.
Inclusive updated-time lower bound.
Exclusive updated-time upper bound.
Cursor from the previous page.
Page size from 1 to 200; defaults to 200.
Include nonempty shift and technician external-ID maps. Defaults to false.
Response
OK response.
Example response
{
"data": [
{
"clockInAtTime": "2026-09-10T15:00:00Z",
"clockInSource": "api",
"clockOutAtTime": "2026-09-10T15:00:00Z",
"clockOutSource": "api",
"createdAtTime": "2026-09-10T15:00:00Z",
"driverId": "281474976710657",
"externalIds": {
"hrisShiftId": "SHIFT-9001"
},
"externalTechnicianIds": {
"hrisShiftId": "SHIFT-9001"
},
"id": "27df219c-2e98-4c4d-9c1f-11dfe40f46ed",
"placeId": "281474976710658",
"status": "inProgress",
"updatedAtTime": "2026-09-10T15:00:00Z",
"userId": "281474976710656",
"version": 1
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.