---
title: "Get Speeding Intervals"
method: GET
path: "/speeding-intervals/stream"
tags: ["Speeding Intervals"]
---

# Get Speeding Intervals

`GET /speeding-intervals/stream`

## Request

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

This endpoint will return all speeding intervals associated with all trips that have been collected for your organization based on the time parameters passed in. Only completed trips are included. Trips with no speeding intervals detected will be returned with an empty list of intervals. Results are paginated.

 <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 Speeding Intervals** under the Speeding Intervals 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

- `assetIds` string[], required
- `startTime` string, required
- `endTime` string
- `queryBy` 'updatedAtTime' | 'tripStartTime'
- `includeAsset` boolean
- `includeDriverId` boolean
- `after` string
- `severityLevels` string[]

## Response `200`

OK response.

- SpeedingIntervalsGetSpeedingIntervalsResponseBody
  - `data` TripSpeedingIntervalsResponseBody[], required: List of speeding intervals associated with trips.
    - `asset` TripAssetResponseBody, required: Asset that the location readings are tied to
      - `id` string, required: Unique ID for the asset object that is reporting the location.
      - `name` string: Name for the asset object that is reporting the location. Only returns when `includeAsset` is set to `true`.
      - `type` 'uncategorized' | 'trailer' | 'equipment' | 'unpowered' | 'vehicle': Type for the asset object that is reporting the location. Only returns when `includeAsset` is set to `true`. Valid values: `uncategorized`, `trailer`, `equipment`, `unpowered`, `vehicle`
      - `vin` string: VIN for the asset object that is reporting the location. Only returns when `includeAsset` is set to `true`.
    - `createdAtTime` string, required: UTC time the trip was created in Samsara in RFC 3339 format.
    - `driverId` string: The driver ID assigned to the trip. Only returned if includeDriverId is set to true. 'null' if no driver id.
    - `intervals` SpeedingIntervalResponseBody[], required: List of speeding intervals that belong to the trip. The full list of intervals associated with the trip is always returned, empty if no intervals exist.
      - `endTime` string, required: UTC time the interval ended in RFC 3339 format.
      - `isDismissed` boolean, required: Whether the interval is dismissed.
      - `location` SpeedingIntervalLocationResponseResponseBody, required: Location object of the closest location point to the interval.
        - `accuracyMeters` number, double: Radial accuracy of gps location in meters. This will only return if strong GPS is not available.
        - `address` AddressResponseResponseBody, required: Closest address that the GPS latitude and longitude match to.
          - `city` string: The name of the city
          - `country` string: The country
          - `neighborhood` string: The name of the neighborhood if one exists
          - `pointOfInterest` string: Point that may be of interest to the user
          - `postalCode` string: The zip code
          - `state` string: The name of the state
          - `street` string: The street name
          - `streetNumber` string: Street number of the address
        - `headingDegrees` integer, required: Heading of the asset in degrees. May be 0 if the asset is not moving.
        - `latitude` number, double, required: Latitude of the closest location point to the interval.
        - `longitude` number, double, required: Longitude of the closest location point to the interval.
      - `maxSpeedKilometersPerHour` number, double, required: The max speed exceeded for the speeding interval.
      - `postedSpeedLimitKilometersPerHour` number, double, required: The posted speed limit associated with the speeding interval.
      - `severityLevel` 'light' | 'moderate' | 'heavy' | 'severe', required: Specifies the severity level of the speeding interval. Valid values: `light`, `moderate`, `heavy`, `severe`
      - `startTime` string, required: UTC time the interval started in RFC 3339 format.
    - `tripStartTime` string, required: UTC time the trip started in RFC 3339 format.
    - `updatedAtTime` string, required: UTC time the trip was last updated in Samsara in RFC 3339 format. Valid updates are when trip's endTime populates or interval.isDismissed changes value.
  - `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)