---
title: "List asset location and speed data in an organization."
method: GET
path: "/assets/location-and-speed/stream"
tags: ["Location and Speed"]
---

# List asset location and speed data in an organization.

`GET /assets/location-and-speed/stream`

## Request

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

This endpoint will return asset locations and speed data that has been collected for your organization 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 the time-series data by device.

 <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 Vehicles** under the Vehicles 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

- `after` string
- `limit` integer
- `startTime` string
- `endTime` string
- `ids` string[]
- `includeSpeed` boolean
- `includeReverseGeo` boolean
- `includeGeofenceLookup` boolean
- `includeHighFrequencyLocations` boolean
- `includeExternalIds` boolean

## Response `200`

OK response.

- LocationAndSpeedGetLocationAndSpeedResponseBody
  - `data` LocationAndSpeedResponseResponseBody[], required: List of location and speed objects.
    - `asset` AssetResponseResponseBody, required: Asset that the location readings are tied to.
      - `externalIds` object: A map of external ids
      - `id` string, required: ID of the asset
    - `happenedAtTime` string, required: UTC timestamp in RFC 3339 format of the event.
    - `location` LocationResponseResponseBody, required: Location object.
      - `accuracyMeters` number, double: Radial accuracy of gps location in meters. This will only return if strong GPS is not available.
      - `address` AddressResponseResponseBody: 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
      - `geofence` GeofenceResponseResponseBody: Closest geofence based on 1000 meter radial search.
        - `externalIds` object: A map of external ids
        - `id` string: Unique ID of the geofence object.
      - `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 location of the asset.
      - `longitude` number, double, required: Longitude of the location of the asset.
    - `speed` SpeedResponseResponseBody: Speed object.
      - `ecuSpeedMetersPerSecond` number, double: Speed of asset based on ECU data.
      - `gpsSpeedMetersPerSecond` number, double: Speed of asset based on GPS data.
  - `pagination` GoaPaginationWithTokensResponseResponseBody, required: Pagination parameters.
    - `endCursor` string: 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)