Assets

List current location for all assets

🚧 This endpoint is still on our legacy API.

Fetch current locations of all assets.

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 Equipment Statistics under the Equipment 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/v1/fleet/assets/locations

Request

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

Query parameters

startingAfterstring

Pagination parameter indicating the cursor position to continue returning results after. Used in conjunction with the 'limit' parameter. Mutually exclusive with 'endingBefore' parameter.

endingBeforestring

Pagination parameter indicating the cursor position to return results before. Used in conjunction with the 'limit' parameter. Mutually exclusive with 'startingAfter' parameter.

limitnumber

Pagination parameter indicating the number of results to return in this request. Used in conjunction with either 'startingAfter' or 'endingBefore'.

Response

List of assets and their current locations.

Example response

{
  "assets": [
    {
      "assetSerialNumber": "8dka2810",
      "cable": {
        "assetType": "Thermo King"
      },
      "engineHours": 104,
      "id": 1,
      "location": [
        {
          "latitude": 37,
          "location": "525 York, San Francisco, CA",
          "longitude": -122.7,
          "speedMilesPerHour": 35,
          "timeMs": 12314151
        }
      ],
      "name": "Trailer 123"
    }
  ],
  "pagination": {
    "endCursor": "MTU5MTEzNjA2OTU0MzQ3",
    "startCursor": "MTU5MTEzNjA2OTU0MzQ3"
  }
}

Changes

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