---
updatedAt: 2026-05-27T07:50:08.000Z
---
Fetch the complete documentation index at: https://developers.samsara.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.
# List asset location and speed data in an organization.
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.
Rate limit: 10 requests/sec (learn more about rate limits here).
To use this endpoint, select **Read Vehicles** under the Vehicles category when creating or editing an API token. Learn More.
**Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.
# OpenAPI definition
````json
{
"components": {
"schemas": {
"AddressResponseResponseBody": {
"description": "Closest address that the GPS latitude and longitude match to.",
"properties": {
"city": {
"description": "The name of the city",
"example": "New York",
"type": "string"
},
"country": {
"description": "The country",
"example": "USA",
"type": "string"
},
"neighborhood": {
"description": "The name of the neighborhood if one exists",
"example": "Mission District",
"type": "string"
},
"pointOfInterest": {
"description": "Point that may be of interest to the user",
"example": "The Eiffel Tower",
"type": "string"
},
"postalCode": {
"description": "The zip code",
"example": "10010",
"type": "string"
},
"state": {
"description": "The name of the state",
"example": "New York",
"type": "string"
},
"street": {
"description": "The street name",
"example": "Main Street",
"type": "string"
},
"streetNumber": {
"description": "Street number of the address",
"example": "16",
"type": "string"
}
},
"type": "object"
},
"AssetResponseResponseBody": {
"description": "Asset that the location readings are tied to.",
"properties": {
"externalIds": {
"additionalProperties": {
"type": "string"
},
"description": "A map of external ids",
"type": "object"
},
"id": {
"description": "ID of the asset",
"example": "12345",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"GeofenceResponseResponseBody": {
"description": "Closest geofence based on 1000 meter radial search.",
"properties": {
"externalIds": {
"additionalProperties": {
"type": "string"
},
"description": "A map of external ids",
"type": "object"
},
"id": {
"description": "Unique ID of the geofence object.",
"example": "12345",
"type": "string"
}
},
"type": "object"
},
"GoaPaginationWithTokensResponseResponseBody": {
"description": "Pagination parameters.",
"properties": {
"endCursor": {
"description": "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.",
"example": "MjkY",
"type": "string"
},
"hasNextPage": {
"description": "True if there are more pages of results immediately available after this endCursor.",
"example": true,
"type": "boolean"
}
},
"required": [
"hasNextPage"
],
"type": "object"
},
"LocationAndSpeedGetLocationAndSpeedBadGatewayErrorResponseBody": {
"description": "Bad Gateway",
"properties": {
"message": {
"description": "Message of error",
"example": "rpc error: code = Unknown desc = connection refused",
"type": "string"
},
"requestId": {
"description": "The request ID; used when reaching out to support for issues with requests.",
"example": "8916e1c1",
"type": "string"
}
},
"required": [
"message",
"requestId"
],
"type": "object"
},
"LocationAndSpeedGetLocationAndSpeedBadRequestErrorResponseBody": {
"description": "Bad Request parameters",
"properties": {
"message": {
"description": "Message of error",
"example": "Invalid value for parameter.",
"type": "string"
},
"requestId": {
"description": "The request ID; used when reaching out to support for issues with requests.",
"example": "8916e1c1",
"type": "string"
}
},
"required": [
"message",
"requestId"
],
"type": "object"
},
"LocationAndSpeedGetLocationAndSpeedContentTooLargeErrorResponseBody": {
"description": "Content Too Large",
"properties": {
"message": {
"description": "Message of error",
"example": "Request content too large.",
"type": "string"
},
"requestId": {
"description": "The request ID; used when reaching out to support for issues with requests.",
"example": "8916e1c1",
"type": "string"
}
},
"required": [
"message",
"requestId"
],
"type": "object"
},
"LocationAndSpeedGetLocationAndSpeedGatewayTimeoutErrorResponseBody": {
"description": "Gateway timeout",
"properties": {
"message": {
"description": "Message of error",
"example": "context deadline exceeded",
"type": "string"
},
"requestId": {
"description": "The request ID; used when reaching out to support for issues with requests.",
"example": "8916e1c1",
"type": "string"
}
},
"required": [
"message",
"requestId"
],
"type": "object"
},
"LocationAndSpeedGetLocationAndSpeedInternalServerErrorResponseBody": {
"description": "An internal server error occurred",
"properties": {
"message": {
"description": "Message of error",
"example": "Failed to execute GraphQL query.",
"type": "string"
},
"requestId": {
"description": "The request ID; used when reaching out to support for issues with requests.",
"example": "8916e1c1",
"type": "string"
}
},
"required": [
"message",
"requestId"
],
"type": "object"
},
"LocationAndSpeedGetLocationAndSpeedMethodNotAllowedErrorResponseBody": {
"description": "Method not allowed",
"properties": {
"message": {
"description": "Message of error",
"example": "DELETE not allowed on /endpoint.",
"type": "string"
},
"requestId": {
"description": "The request ID; used when reaching out to support for issues with requests.",
"example": "8916e1c1",
"type": "string"
}
},
"required": [
"message",
"requestId"
],
"type": "object"
},
"LocationAndSpeedGetLocationAndSpeedNotFoundErrorResponseBody": {
"description": "Resource not found",
"properties": {
"message": {
"description": "Message of error",
"example": "Object not found.",
"type": "string"
},
"requestId": {
"description": "The request ID; used when reaching out to support for issues with requests.",
"example": "8916e1c1",
"type": "string"
}
},
"required": [
"message",
"requestId"
],
"type": "object"
},
"LocationAndSpeedGetLocationAndSpeedNotImplementedErrorResponseBody": {
"description": "Requested endpoint is not yet implemented",
"properties": {
"message": {
"description": "Message of error",
"example": "Not implemented.",
"type": "string"
},
"requestId": {
"description": "The request ID; used when reaching out to support for issues with requests.",
"example": "8916e1c1",
"type": "string"
}
},
"required": [
"message",
"requestId"
],
"type": "object"
},
"LocationAndSpeedGetLocationAndSpeedResponseBody": {
"properties": {
"data": {
"description": "List of location and speed objects.",
"items": {
"$ref": "#/components/schemas/LocationAndSpeedResponseResponseBody"
},
"type": "array"
},
"pagination": {
"$ref": "#/components/schemas/GoaPaginationWithTokensResponseResponseBody"
}
},
"required": [
"data",
"pagination"
],
"type": "object"
},
"LocationAndSpeedGetLocationAndSpeedServiceUnavailableErrorResponseBody": {
"description": "Service unavailable",
"properties": {
"message": {
"description": "Message of error",
"example": "context deadline exceeded",
"type": "string"
},
"requestId": {
"description": "The request ID; used when reaching out to support for issues with requests.",
"example": "8916e1c1",
"type": "string"
}
},
"required": [
"message",
"requestId"
],
"type": "object"
},
"LocationAndSpeedGetLocationAndSpeedTooManyRequestsErrorResponseBody": {
"description": "Too many requests",
"properties": {
"message": {
"description": "Message of error",
"example": "Exceeded rate limit.",
"type": "string"
},
"requestId": {
"description": "The request ID; used when reaching out to support for issues with requests.",
"example": "8916e1c1",
"type": "string"
}
},
"required": [
"message",
"requestId"
],
"type": "object"
},
"LocationAndSpeedGetLocationAndSpeedUnauthorizedErrorResponseBody": {
"description": "Unauthorized",
"properties": {
"message": {
"description": "Message of error",
"example": "Invalid token.",
"type": "string"
},
"requestId": {
"description": "The request ID; used when reaching out to support for issues with requests.",
"example": "8916e1c1",
"type": "string"
}
},
"required": [
"message",
"requestId"
],
"type": "object"
},
"LocationAndSpeedResponseResponseBody": {
"description": "Full location and speed objects.",
"properties": {
"asset": {
"$ref": "#/components/schemas/AssetResponseResponseBody"
},
"happenedAtTime": {
"description": "UTC timestamp in RFC 3339 format of the event.",
"example": "2020-01-27T07:06:25Z",
"type": "string"
},
"location": {
"$ref": "#/components/schemas/LocationResponseResponseBody"
},
"speed": {
"$ref": "#/components/schemas/SpeedResponseResponseBody"
}
},
"required": [
"asset",
"happenedAtTime",
"location"
],
"type": "object"
},
"LocationResponseResponseBody": {
"description": "Location object.",
"properties": {
"accuracyMeters": {
"description": "Radial accuracy of gps location in meters. This will only return if strong GPS is not available.",
"example": 5.801,
"format": "double",
"type": "number"
},
"address": {
"$ref": "#/components/schemas/AddressResponseResponseBody"
},
"geofence": {
"$ref": "#/components/schemas/GeofenceResponseResponseBody"
},
"headingDegrees": {
"description": "Heading of the asset in degrees. May be 0 if the asset is not moving.",
"example": 120,
"format": "int64",
"type": "integer"
},
"latitude": {
"description": "Latitude of the location of the asset.",
"example": 37.7749,
"format": "double",
"type": "number"
},
"longitude": {
"description": "Longitude of the location of the asset.",
"example": 137.2719,
"format": "double",
"type": "number"
}
},
"required": [
"headingDegrees",
"latitude",
"longitude"
],
"type": "object"
},
"SpeedResponseResponseBody": {
"description": "Speed object.",
"properties": {
"ecuSpeedMetersPerSecond": {
"description": "Speed of asset based on ECU data.",
"example": 30.2,
"format": "double",
"type": "number"
},
"gpsSpeedMetersPerSecond": {
"description": "Speed of asset based on GPS data.",
"example": 30.2,
"format": "double",
"type": "number"
}
},
"type": "object"
}
},
"securitySchemes": {
"AccessTokenHeader": {
"type": "http",
"scheme": "bearer"
}
}
},
"info": {
"description": "# Overview\n\n> 📘 Something new!\n>\n> Welcome Samsara's new and improved API. Check out our FAQ [here](https://developers.samsara.com/docs/introducing-our-next-generation-api) to see what's changed and learn how to get started.\n>\n> Want to access the legacy API docs? You can find them [here](https://www.samsara.com/api-legacy).\n>\n> _Note: Because this is a new set of APIs, we have not transitioned all endpoints over to this standard. Endpoints that still use the legacy standards are indicated in the reference documentation. If you can't find an API that you're looking for, we encourage you to look for it in our [legacy API docs](https://www.samsara.com/api-legacy) as we continue to transition all endpoints over. Check back here for updates!_\n>\n> Submit your feedback [here](https://forms.gle/r4bs6HQshQAvBuwv6)!\n\nSamsara provides API endpoints so that you can build powerful applications and custom solutions with sensor data. Samsara has endpoints available to track and analyze sensors, vehicles, and entire fleets.\n\nThe Samsara API is a [RESTful API](https://en.wikipedia.org/wiki/Representational_state_transfer). It uses standard [HTTP](https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol) authentication, verbs, and response codes, and it returns [JSON](http://www.json.org/) response bodies. If you're familiar with what you can build with a REST API, then this will be your go-to API reference.\n\nVisit [developers.samsara.com](https://developers.samsara.com) to find getting started guides and an API overview.\n\nIf you have any questions, please visit https://samsara.com/help.\n\n## Endpoints\n\nAll our APIs can be accessed through HTTP requests to URLs like:\n\n```\nhttps://api.samsara.com/\n```\n\nFor EU customers, this URL will be:\n\n```\nhttps://api.eu.samsara.com/\n```\n\n> 🚧 Note\n>\n> Legacy endpoints will have the URL: `https://api.samsara.com/v1/` or `https://api.eu.samsara.com/v1/`\n\n## Authentication\n\nTo authenticate your API request you will need to include your secret token. You can manage your API tokens in the [Dashboard](https://cloud.samsara.com). They are visible under `Settings->Organization->API Tokens`.\n\nYour API tokens carry many privileges, so be sure to keep them secure. Do not share your secret API tokens in publicly accessible areas such as GitHub, client-side code, and so on.\n\nAuthentication to the API is performed via Bearer Token in the HTTP Authorization header. Provide your API token as the `access_token` value in an `Authorization: Bearer` header. You do not need to provide a password:\n\n```curl\nAuthorization: Bearer {access_token}\n```\n\nAll API requests must be made over [HTTPS](https://en.wikipedia.org/wiki/HTTPS). Calls made over plain HTTP or without authentication will fail.\n\n### OAuth2\n\nIf building an application for our marketplace, our API is accessible via. OAuth2 as well.\n\n| Type | Value |\n| ----------------- | :--------------------------------------: |\n| Security scheme | OAuth2 |\n| OAuth2 Flow | accessCode |\n| Authorization URL | https://api.samsara.com/oauth2/authorize |\n| Token URL | https://api.samsara.com/oauth2/token |\n\n## Common Patterns\n\nYou can find more info about request methods, response codes, error codes, versioning, pagination, timestamps, and mini-objects [here](https://developers.samsara.com/docs/common-structures).\n",
"title": "Samsara API",
"version": "2025-10-23"
},
"openapi": "3.0.1",
"paths": {
"/assets/location-and-speed/stream": {
"get": {
"description": "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.\n\n Rate limit: 10 requests/sec (learn more about rate limits here).\n\nTo use this endpoint, select **Read Vehicles** under the Vehicles category when creating or editing an API token. Learn More.\n \n\n **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.",
"operationId": "getLocationAndSpeed",
"parameters": [
{
"description": " If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results.",
"in": "query",
"name": "after",
"schema": {
"type": "string"
}
},
{
"description": "The limit for how many objects will be in the response. Default and max for this value is 512 objects.",
"in": "query",
"name": "limit",
"schema": {
"default": 512,
"maximum": 512,
"minimum": 1,
"type": "integer"
}
},
{
"description": " A start time in RFC 3339 format. Defaults to now if not provided. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).",
"in": "query",
"name": "startTime",
"schema": {
"type": "string"
}
},
{
"description": " An end time in RFC 3339 format. Defaults to never if not provided; if not provided then pagination will not cease, and a valid pagination cursor will always be returned. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).",
"in": "query",
"name": "endTime",
"schema": {
"type": "string"
}
},
{
"description": "Comma-separated list of asset IDs.",
"explode": false,
"in": "query",
"name": "ids",
"schema": {
"items": {
"type": "string"
},
"type": "array"
},
"style": "form"
},
{
"description": "Optional boolean indicating whether or not to return the 'speed' object",
"in": "query",
"name": "includeSpeed",
"schema": {
"type": "boolean"
}
},
{
"description": "Optional boolean indicating whether or not to return the 'address' object. Address information won't be returned for high-frequency locations.",
"in": "query",
"name": "includeReverseGeo",
"schema": {
"type": "boolean"
}
},
{
"description": "Optional boolean indicating whether or not to return the 'geofence' object",
"in": "query",
"name": "includeGeofenceLookup",
"schema": {
"type": "boolean"
}
},
{
"description": "Optional boolean indicating whether or not to return high-frequency location data (up to 1Hz). Cannot be used with includeGeofenceLookup.",
"in": "query",
"name": "includeHighFrequencyLocations",
"schema": {
"type": "boolean"
}
},
{
"description": "Optional boolean indicating whether to return external IDs on supported entities",
"in": "query",
"name": "includeExternalIds",
"schema": {
"type": "boolean"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LocationAndSpeedGetLocationAndSpeedResponseBody"
}
}
},
"description": "OK response."
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LocationAndSpeedGetLocationAndSpeedUnauthorizedErrorResponseBody"
}
}
},
"description": "Unauthorized response."
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LocationAndSpeedGetLocationAndSpeedNotFoundErrorResponseBody"
}
}
},
"description": "Not Found response."
},
"405": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LocationAndSpeedGetLocationAndSpeedMethodNotAllowedErrorResponseBody"
}
}
},
"description": "Method Not Allowed response."
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LocationAndSpeedGetLocationAndSpeedContentTooLargeErrorResponseBody"
}
}
},
"description": "Content Too Large response."
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LocationAndSpeedGetLocationAndSpeedTooManyRequestsErrorResponseBody"
}
}
},
"description": "Too Many Requests response."
},
"500": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LocationAndSpeedGetLocationAndSpeedInternalServerErrorResponseBody"
}
}
},
"description": "Internal Server Error response."
},
"501": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LocationAndSpeedGetLocationAndSpeedNotImplementedErrorResponseBody"
}
}
},
"description": "Not Implemented response."
},
"502": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LocationAndSpeedGetLocationAndSpeedBadGatewayErrorResponseBody"
}
}
},
"description": "Bad Gateway response."
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LocationAndSpeedGetLocationAndSpeedServiceUnavailableErrorResponseBody"
}
}
},
"description": "Service Unavailable response."
},
"504": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LocationAndSpeedGetLocationAndSpeedGatewayTimeoutErrorResponseBody"
}
}
},
"description": "Gateway Timeout response."
},
"default": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LocationAndSpeedGetLocationAndSpeedBadRequestErrorResponseBody"
}
}
},
"description": "Bad Request response."
}
},
"summary": "List asset location and speed data in an organization.",
"tags": [
"Location and Speed"
]
}
}
},
"security": [
{
"AccessTokenHeader": []
}
],
"servers": [
{
"url": "https://api.samsara.com"
},
{
"url": "https://api.eu.samsara.com"
},
{
"url": "https://api.ca.samsara.com"
}
],
"x-original-swagger-version": "2.0"
}
````