---
title: "[beta] List asset inputs data in an organization."
method: GET
path: "/assets/inputs/stream"
tags: ["Beta APIs"]
---

# \[beta\] List asset inputs data in an organization.

`GET /assets/inputs/stream`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/assets/inputs/stream`
- Auth: HTTP bearer

This endpoint will return data collected from the inputs of your organization's assets based on the time parameters passed in. Results are paginated. If you include an endTime, the endpoint will return data up until that point. If you don’t include an endTime, you can continue to poll the API real-time with the pagination cursor that gets returned on every call. The endpoint will only return data up until the endTime that has been processed by the server at the time of the original request. You will need to request the same [startTime, endTime) range again to receive data for assets processed after the original request time. This endpoint sorts data by time ascending.

 <b>Rate limit:</b> 10 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 Assets** under the Assets 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.

## Query parameters

- `ids` string[], required
- `type` 'auxInput1' | 'auxInput2' | 'auxInput3' | 'auxInput4' | 'auxInput5' | 'auxInput6' | 'auxInput7' | 'auxInput8' | 'auxInput9' | 'auxInput10' | 'auxInput11' | 'auxInput12' | 'auxInput13' | 'analogInput1Voltage' | 'analogInput2Voltage' | 'analogInput1Current' | 'analogInput2Current' | 'batteryVoltage', required
- `after` string
- `startTime` string, required
- `endTime` string
- `includeExternalIds` boolean
- `includeTags` boolean
- `includeAttributes` boolean

## Response `200`

OK response.

- AssetsInputsGetAssetsInputsResponseBody
  - `data` AssetsInputsResponseResponseBody[], required: Array of assets inputs objects.
    - `asset` AssetsInputsAssetResponseResponseBody, required: Asset that the input data is from.
      - `attributes` GoaAttributeTinyResponseBody[]: List of attributes associated with the entity
        - `dateValues` string[]: List of date values associated with the attribute (RFC 3339 full-date format: YYYY-MM-DD).
        - `id` string: Id of the attribute
        - `name` string: Name of the attribute
        - `numberValues` number[]: List of number values associated with the attribute
        - `stringValues` string[]: List of string values associated with the attribute.
      - `externalIds` object: A map of external ids
      - `id` string, required: ID of the asset
      - `tags` GoaTagTinyResponseResponseBody[]: The array of [tags](https://kb.samsara.com/hc/en-us/articles/360026674631-Using-Tags-and-Tag-Nesting) associated with the Asset.
        - `id` string, required: ID of the tag
        - `name` string, required: Name of the tag.
        - `parentTagId` string: If this tag is part a hierarchical tag tree, this is the ID of the parent tag, otherwise this will be omitted.
    - `auxInput` AssetsInputsAuxInputResponseBody: Auxiliary input metadata
      - `name` string, required: Name of the auxiliary input
    - `happenedAtTime` string, required: UTC timestamp in RFC 3339 format of the event.
    - `units` 'boolean' | 'millivolts' | 'microamps', required: Units of the values in the returned data. Valid values: `boolean`, `millivolts`, `microamps`
    - `value` string, required: Value of the data point.
  - `pagination` GoaPaginationResponseResponseBody, required: Pagination parameters.
    - `endCursor` 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

- `401`: Unauthorized response.
- `404`: Not Found response.
- `405`: Method Not Allowed response.
- `413`: Content Too Large response.
- `429`: Too Many Requests response.
- `500`: Internal Server Error response.
- `501`: Not Implemented response.
- `502`: Bad Gateway response.
- `503`: Service Unavailable response.
- `504`: Gateway Timeout response.
- `default`: Bad Request response.

---

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