---
title: "List all assets."
method: GET
path: "/assets"
tags: ["Assets"]
---

# List all assets.

`GET /assets`

## Request

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

List all assets. Up to 300 assets will be returned per page.

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

- `type` 'uncategorized' | 'trailer' | 'equipment' | 'unpowered' | 'vehicle'
- `after` string
- `updatedAfterTime` string
- `includeExternalIds` boolean
- `includeTags` boolean
- `tagIds` string
- `parentTagIds` string
- `ids` string[]
- `externalIds` string[]
- `attributeValueIds` string
- `attributes` string[]
- `includeAttributes` boolean

## Response `200`

OK response.

- AssetsListAssetsResponseBody
  - `data` AssetResponseBody[], required: List of assets
    - `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.
    - `createdAtTime` string, required: The time the asset was created in RFC 3339 format.
    - `externalIds` object: A map of external ids
    - `id` string, required: The unique ID of the asset.
    - `licensePlate` string: The license plate of the asset.
    - `make` string: The OEM/manufacturer of the asset. Updates to this field are restricted.
    - `model` string: The model of the asset. Updates to this field are restricted.
    - `name` string: The human-readable name of the asset. This is set by a fleet administrator and will appear in both Samsara’s cloud dashboard as well as the Samsara Driver mobile app. By default, this name is the serial number of the Samsara Asset Gateway. It can be set or updated through the Samsara Dashboard or through the API at any time.
    - `notes` string: These are generic notes about the asset. Can be set or updated through the Samsara Dashboard or the API at any time.
    - `readingsIngestionEnabled` boolean: Indicates whether the asset is expected to have data ingested using the Readings API. Do not set this to true for an asset that has, or is intended to have, a connected gateway.
    - `regulationMode` 'mixed' | 'regulated' | 'unregulated': Whether or not the asset is regulated, unregulated (non-CMV), or a mixed use unregulated asset. Primarily used with vehicles. Valid values: `mixed`, `regulated`, `unregulated`
    - `serialNumber` string: The serial number of the asset. This can be an internal serial number or used to hold legacy VIN/PIN numbers such as ones of shorter lengths.
    - `tags` GoaTagTinyResponseResponseBody[]: The list 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.
    - `type` 'uncategorized' | 'trailer' | 'equipment' | 'unpowered' | 'vehicle': The operational context in which the asset interacts with the Samsara system. Examples: Vehicle (eg: truck, bus...), Trailer (eg: dry van, reefer, flatbed...), Powered Equipment (eg: dozer, crane...), Unpowered Equipment (eg: container, dumpster...), or Uncategorized. Valid values: `uncategorized`, `trailer`, `equipment`, `unpowered`, `vehicle`
    - `updatedAtTime` string, required: The time the asset was last updated in RFC 3339 format.
    - `vin` string: The unique 17-digit VIN (Vehicle Identification Number) or PIN (Product Identification Number) of the asset.
    - `year` integer: The model year of the asset. Updates to this field are restricted.
  - `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)