---
title: "Get a stream of filtered issues."
method: GET
path: "/issues/stream"
tags: ["Issues"]
---

# Get a stream of filtered issues.

`GET /issues/stream`

## Request

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

Returns all issues data that has been created or modified for your organization based on the time parameters passed in. Results are paginated and are sorted by last modified date. If you include an endTime, the endpoint will return data up until that point (exclusive). 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.

 <b>Rate limit:</b> 5 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 Issues** under the Forms 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

- `startTime` string, required
- `endTime` string
- `after` string
- `status` string[]
- `assetIds` string[]
- `assetExternalIds` string[]
- `include` string[]
- `assignedToRouteStopIds` string[]

## Response `200`

OK response.

- IssuesGetIssuesStreamResponseBody
  - `data` IssueResponseObjectResponseBody[], required: List of issues.
    - `asset` FormsAssetObjectResponseBody: Tracked or untracked (i.e. manually entered) asset object.
      - `entryType` 'tracked' | 'untracked', required: The type of entry for the asset. Valid values: `tracked`, `untracked`
      - `externalIds` object: A map of external ids
      - `id` string: ID of a tracked asset. Included if 'entryType' is `tracked`.
      - `name` string: Name of an untracked (i.e. manually entered) asset.
    - `assignedTo` FormsPolymorphicUserObjectResponseBody: User or driver object.
      - `id` string, required: ID of the polymorphic user.
      - `type` 'driver' | 'user', required: The type of the polymorphic user. Valid values: `driver`, `user`
    - `createdAtTime` string, date-time, required: Creation time of the issue. UTC timestamp in RFC 3339 format.
    - `description` string: Description of the issue. Included if the issue was given a description.
    - `dueDate` string, date-time: Due date of the issue. UTC timestamp in RFC 3339 format. Included if the issue was assigned a due date.
    - `externalIds` object: A map of external ids
    - `id` string, required: ID of the issue.
    - `issueSource` IssueSourceObjectResponseBody, required: Contains information about where an issue came from.
      - `id` string: ID of the issue's source object. The format depends on the 'type'. Included if 'type' is not 'ad-hoc'.
      - `type` 'form' | 'ad-hoc', required: The type of issue source. Valid values: `form`, `ad-hoc`
    - `mediaList` FormsMediaRecordObjectResponseBody[]: List of media objects for the issue. Included if the issue has media.
      - `id` string, uuid, required: ID of the media record.
      - `processingStatus` 'unknown' | 'processing' | 'finished', required: Status of the media record. Valid values: `unknown`, `processing`, `finished`
      - `url` string, uri: URL containing a link to associated media content. Included if 'processingStatus' is 'finished'.
      - `urlExpiresAt` string, date-time: Expiration time of the media record 'url'. UTC timestamp in RFC 3339 format.
    - `priority` 'low' | 'medium' | 'high': Priority of the issue. Included if the issue was assigned a priority. Valid values: `low`, `medium`, `high`
    - `status` 'open' | 'inProgress' | 'resolved' | 'dismissed', required: Status of the issue. Valid values: `open`, `inProgress`, `resolved`, `dismissed`
    - `submittedAtTime` string, date-time, required: Submission time of the issue. UTC timestamp in RFC 3339 format.
    - `submittedBy` FormsPolymorphicUserObjectResponseBody, required: User or driver object.
      - `id` string, required: ID of the polymorphic user.
      - `type` 'driver' | 'user', required: The type of the polymorphic user. Valid values: `driver`, `user`
    - `title` string, required: Title of the issue.
    - `updatedAtTime` string, date-time, required: Update time of the issue. UTC timestamp in RFC 3339 format.
  - `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)