Beta APIs

[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.

get/maintenance/technician-shifts

Request

  • Base URL
    https://api.samsara.com
  • Auth
    HTTP bearer

Query parameters

idsstring[]

Up to 100 comma-separated shift identifiers.

userIdsstring[]

Up to 100 comma-separated user IDs.

externalTechnicianIdsstring[]

Up to 100 comma-separated employee aliases.

startTimestring date-time

Inclusive updated-time lower bound.

endTimestring date-time

Exclusive updated-time upper bound.

afterstring

Cursor from the previous page.

limitinteger

Page size from 1 to 200; defaults to 200.

includeExternalIdsboolean

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.