Users

Retrieve a user

Get a specific user's information. Users that have expired access will not be returned.

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.

To use this endpoint, select Read Users under the Setup & Administration 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>

get/users/{id}

Request

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

Path parameters

idstring required

Unique identifier for the user.

Response

Returns the specified user.

Example response

{
  "data": {
    "email": "user@company.com",
    "id": "123",
    "name": "Bob Smith",
    "roles": [
      {
        "expireAt": "2025-08-13T19:08:25Z",
        "role": {
          "id": "8a9371af-82d1-4158-bf91-4ecc8d3a114c",
          "name": "Full Admin"
        },
        "tag": {
          "id": "3914",
          "name": "East Coast",
          "parentTagId": "4815"
        }
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.