---
title: "List historical data points for data inputs"
method: GET
path: "/industrial/data-inputs/data-points/history"
tags: ["Industrial"]
---

# List historical data points for data inputs

`GET /industrial/data-inputs/data-points/history`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/industrial/data-inputs/data-points/history`
- Auth: HTTP bearer

Returns all known data points during the given time range for all data inputs. This can be filtered by optional tags, specific data input IDs or asset IDs. 

 **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>

## Query parameters

- `startTime` string, required
- `endTime` string, required
- `after` string
- `parentTagIds` string[]
- `tagIds` string[]
- `dataInputIds` string[]
- `assetIds` string[]

## Response `200`

List of all data points for the specified data inputs and time range.

- DataInputListResponse
  - `data` DataInputResponse[]: An array of data input data points. Each object in the array represents a data input and will contain its associated data points.
    - `assetId` string, uuid: Unique identifier for the data input's asset.
    - `dataGroup` string, string: Data group for this data input.
    - `id` string, uuid: Unique identifier for the data input.
    - `name` string, string: Name of this data input.
    - `units` string, string: Units of data for this data input.
    - `fftSpectraPoints` FftSpectraDataPoint[]: List of FFT spectra data points from the data input.
      - `fftSpectra` FftSpectraDataPointFftSpectra: FFT spectrum data
        - `frequencies` number[]: Frequencies
        - `x` number[]: X-axis data
        - `y` number[]: Y-axis data
        - `z` number[]: Z-axis data
      - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`.
    - `j1939D1StatusPoints` J1939D1StatusDataPoint[]: List of active J1939D1 statuses.
      - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`.
      - `value` J1939D1StatusDataPointValue[]: List of active statuses.
        - `amberLampStatus` number
        - `fmi` number
        - `milStatus` number
        - `occuranceCount` number
        - `protectLampStatus` number
        - `redLampStatus` number
        - `spn` number
        - `txId` number
    - `locationPoints` LocationDataPoint[]: List of location data points from the data input.
      - `gpsLocation` LocationDataPointGpsLocation: GPS location information of the data input's datapoint.
        - `formattedAddress` string, string: Formatted address of the location
        - `gpsMetersPerSecond` number, double: Speed of GPS (meters per second)
        - `headingDegrees` number, double: Heading degrees
        - `latitude` number, double: Latitude of the location
        - `longitude` number, double: Longitude of the location
        - `place` LocationDataPointGpsLocationPlace: Address of the location
          - `city` string, string: City
          - `houseNumber` string, string: House number
          - `neighborhood` string, string: Neighborhood
          - `poi` string, string: POI
          - `postcode` string, string: Postcode
          - `state` string, string: State
          - `street` string, string: Street
      - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`.
    - `numberPoints` NumberDataPoint[]: List of numeric data points from the data input.
      - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`.
      - `value` number, double: Numeric value of the data point.
    - `stringPoints` StringDataPoint[]: List of string data points from the data input.
      - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`.
      - `value` string, string: String value of the data point.
  - `pagination` PaginationResponse: Pagination parameters.
    - `endCursor` string, string, required: Cursor identifier representing the last element in the response. This value should be used in conjunction with a subsequent request's 'after' query parameter. This may be an empty string if there are no more pages left to view.
    - `hasNextPage` boolean, required: True if there are more pages of results immediately available after this endCursor.

## Other responses

- `default`: Unexpected error.

---

[API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)