---
title: "List all vehicles."
method: GET
path: "/fleet/vehicles"
tags: ["Vehicles"]
---

# List all vehicles.

`GET /fleet/vehicles`

## Request

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

Returns a list of all vehicles.

 <b>Rate limit:</b> 25 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

- `limit` integer
- `after` string
- `parentTagIds` string
- `tagIds` string
- `attributeValueIds` string
- `attributes` string[]
- `updatedAfterTime` string
- `createdAfterTime` string

## Response `200`

OK response.

- VehiclesListVehiclesResponseBody
  - `data` VehicleResponseObjectResponseBody[], required: Multiple vehicles.
    - `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.
    - `auxInputType1` string: The type of auxiliary input configured for this Vehicle.
    - `auxInputType10` string: The type of auxiliary input configured for this Vehicle.
    - `auxInputType11` string: The type of auxiliary input configured for this Vehicle.
    - `auxInputType12` string: The type of auxiliary input configured for this Vehicle.
    - `auxInputType13` string: The type of auxiliary input configured for this Vehicle.
    - `auxInputType2` string: The type of auxiliary input configured for this Vehicle.
    - `auxInputType3` string: The type of auxiliary input configured for this Vehicle.
    - `auxInputType4` string: The type of auxiliary input configured for this Vehicle.
    - `auxInputType5` string: The type of auxiliary input configured for this Vehicle.
    - `auxInputType6` string: The type of auxiliary input configured for this Vehicle.
    - `auxInputType7` string: The type of auxiliary input configured for this Vehicle.
    - `auxInputType8` string: The type of auxiliary input configured for this Vehicle.
    - `auxInputType9` string: The type of auxiliary input configured for this Vehicle.
    - `cameraSerial` string: The serial number of the camera installed in the vehicle
    - `createdAtTime` string, date-time, required: Time the vehicle was created in RFC 3339 format.
    - `esn` string: Engine serial number.
    - `externalIds` object: A map of external ids
    - `gateway` GoaGatewayTinyResponseResponseBody: A minified gateway object
      - `model` 'AG15' | 'AG24' | 'AG24EU' | 'AG26' | 'AG26EU' | 'AG41' | 'AG41EU' | 'AG45' | 'AG45EU' | 'AG46' | 'AG46EU' | 'AG46P' | 'AG46PEU' | 'AG51' | 'AG51EU' | 'AG52' | 'AG52EU' | 'AG53' | 'AG53EU' | 'AT11' | 'AT11X' | 'AT12' | 'AT12X' | 'AT13' | 'IG15' | 'IG21' | 'IG41' | 'IG61' | 'SG1' | 'SG1B' | 'SG1G' | 'SG1G32' | 'SG1x' | 'VG32' | 'VG33' | 'VG34' | 'VG34EU' | 'VG34FN' | 'VG34M' | 'VG54ATT' | 'VG54EU' | 'VG54FN' | 'VG54NA' | 'VG54NAE' | 'VG54NAH' | 'VG55EU' | 'VG55FN' | 'VG55NA', required: The model of the gateway installed on the asset. Valid values: `AG15`, `AG24`, `AG24EU`, `AG26`, `AG26EU`, `AG41`, `AG41EU`, `AG45`, `AG45EU`, `AG46`, `AG46EU`, `AG46P`, `AG46PEU`, `AG51`, `AG51EU`, `AG52`, `AG52EU`, `AG53`, `AG53EU`, `AT11`, `AT11X`, `AT12`, `AT12X`, `AT13`, `IG15`, `IG21`, `IG41`, `IG61`, `SG1`, `SG1B`, `SG1G`, `SG1G32`, `SG1x`, `VG32`, `VG33`, `VG34`, `VG34EU`, `VG34FN`, `VG34M`, `VG54ATT`, `VG54EU`, `VG54FN`, `VG54NA`, `VG54NAE`, `VG54NAH`, `VG55EU`, `VG55FN`, `VG55NA`
      - `serial` string, required: The serial number of the gateway installed on the asset.
    - `harshAccelerationSettingType` string: The harsh acceleration setting type.
    - `id` string, required: ID of the vehicle
    - `isRemotePrivacyButtonEnabled` boolean: Whether the remote privacy button is enabled for the vehicle. If omitted, the organization does not have the remote privacy button feature enabled.
    - `licensePlate` string: The license plate of the vehicle.
    - `make` string: The Vehicle’s manufacturing make.
    - `model` string: The Vehicle’s manufacturing model.
    - `name` string: Name of the vehicle
    - `notes` string: These are generic notes about the Vehicle.
    - `sensorConfiguration` VehicleSensorConfigurationResponseBody: The sensors configured on a vehicle
      - `areas` VehicleSensorConfigurationAreaResponseBody[]: Configured sensor areas on the vehicle with its associated sensors
        - `cargoSensors` SensorResponseBody[]
          - `id` string, required: ID of the sensor
          - `mac` string, required: The MAC address of the sensor
          - `name` string, required: The name of the sensor
        - `humiditySensors` SensorResponseBody[]
          - `id` string, required: ID of the sensor
          - `mac` string, required: The MAC address of the sensor
          - `name` string, required: The name of the sensor
        - `position` 'back' | 'front' | 'middle', required: Position of the area on vehicle Valid values: `back`, `front`, `middle`
        - `temperatureSensors` SensorResponseBody[]
          - `id` string, required: ID of the sensor
          - `mac` string, required: The MAC address of the sensor
          - `name` string, required: The name of the sensor
      - `doors` VehicleSensorConfigurationDoorResponseBody[]: Configured door monitors on the vehicle
        - `position` 'back' | 'left' | 'right', required: Position of the door monitor on the vehicle Valid values: `back`, `left`, `right`
        - `sensor` SensorResponseBody, required: A sensor
          - `id` string, required: ID of the sensor
          - `mac` string, required: The MAC address of the sensor
          - `name` string, required: The name of the sensor
    - `serial` string: The serial number of the gateway installed in the vehicle.
    - `staticAssignedDriver` DriverObjectResponseBody: Current driver of the vehicle. Note: this parameter includes all assignment sources, not just static assignments.
      - `id` string: ID of the driver.
      - `name` string: Name of the driver.
    - `tags` GoaTagTinyResponseResponseBody[]: The list of tags associated with the Vehicle.
      - `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.
    - `updatedAtTime` string, date-time: Time the vehicle was updated in RFC 3339 format.
    - `vehicleRegulationMode` 'regulated' | 'unregulated': Whether the vehicle is regulated or unregulated (non-CMV). Valid values: `regulated`, `unregulated`
    - `vehicleType` 'unset' | 'passenger' | 'truck' | 'bus': The type of the vehicle. Only returned for customers with commercial speed limits (CSL) enabled. Valid values: `unset`, `passenger`, `truck`, `bus`
    - `vehicleWeight` integer: The weight of the vehicle in either pounds (lb) or kilograms (kg). Unit of weight is unknown. Only returned for customers with commercial speed limits (CSL) enabled.
    - `vehicleWeightInKilograms` integer: The weight of the vehicle in kilograms (kg). Only returned for customers with commercial speed limits (CSL) enabled.
    - `vehicleWeightInPounds` integer: The weight of the vehicle in pounds (lb). Only returned for customers with commercial speed limits (CSL) enabled.
    - `vin` string: The VIN of the vehicle.
    - `year` string
  - `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)