Get machine history

This endpoint is still on our legacy API.

Get historical data for machine objects. This method returns a set of historical data for all machines.

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.

To use this endpoint, select Write Industrial under the Industrial category when creating or editing an API token. Learn More.

POST /v1/machines/history

Get machine history

cURL

curl --request POST \
  --url https://api.samsara.com/v1/machines/history \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "endMs": 1462881998034,
  "startMs": 1462878398034
}
'

200

{
  "machines": [
    {
      "id": 1,
      "name": "1/3 HP Motor",
      "vibrations": [
        {
          "X": 0.01,
          "Y": 1.23,
          "Z": 2.55,
          "time": 1453449599999
        }
      ]
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Time range to query for events

endMs · integer · required

End of the time range, specified in milliseconds UNIX time.

Example:

1462881998034

startMs · integer · required

Beginning of the time range, specified in milliseconds UNIX time.

Example:

1462878398034

Response

200

application/json

List of machine results objects, each containing a time and a datapoint.

Contains the results for a machine history request

machines · object[]

Show child attributes