---
title: "Get all vehicles"
method: GET
path: "/v1/vehicles"
tags: ["Vehicles"]
---

# Get all vehicles

`GET /v1/vehicles`

## Request

- Base URL: `https://api.sandbox.usenash.com`
- URL: `https://api.sandbox.usenash.com/v1/vehicles`
- Auth: none declared

List all vehicles registered for the organization's internal fleet.

## Response `200`

OK

- VehicleResponse: Response for vehicle.
  - `id` string, required: The ID of the vehicle.
  - `name` string, required: The name of the vehicle.
  - `providerid` string, required: The provider ID of the vehicle.
  - `externalidentifier` string, required: The external identifier of the vehicle.
  - `enabled` boolean, required: Whether the vehicle is enabled.
  - `vehicleinfo` VehicleInfo, required: Response for vehicle info.
    - `type` 'bike' | 'motorbike' | 'cargobike' | 'car' | 'suv' | 'pickup_truck' | 'van' | 'truck' | 'large_van' | 'extra_large_van'
    - `make` string, nullable: The make of the vehicle.
    - `model` string, nullable: The model of the vehicle.
    - `licenseplate` string, nullable: The license plate of the vehicle.
    - `color` string, nullable: The color of the vehicle.
    - `year` string, nullable: The year of the vehicle.
  - `vehicleconfig` VehicleConfig, required: Response for vehicle config.
    - `weight` integer, nullable: The weight of the vehicle.
    - `height` integer, nullable: The height of the vehicle.
    - `length` integer, nullable: The length of the vehicle.
    - `width` integer, nullable: The width of the vehicle.
    - `axlecount` integer, nullable: The number of axles on the vehicle.
    - `trailercount` integer, nullable: The number of trailers on the vehicle.
    - `weightunit` 'kg' | 'lbs', nullable: Unit for weight: 'kg' or 'lbs'. Defaults to 'kg'.
    - `lengthunit` 'meter' | 'in', nullable: Unit for length, width, and height: 'meter' or 'in'. Defaults to 'meter'.
    - `maxstops` integer, nullable: The max stops of the vehicle.
    - `maxdistance` integer, nullable: The max distance of the vehicle.
    - `maxduration` integer, nullable: The max duration of the vehicle.
    - `speedfactor` number, nullable: The speed factor of the vehicle.
    - `capabilities` string[], nullable: The capabilities of the vehicle.
    - `fixedcost` number, nullable: Fixed cost to assign this vehicle with tasks.
    - `costperunitdistance` number, nullable: Cost per unit distance for this vehicle.
    - `costperunittime` number, nullable: Cost per unit time for this vehicle.
    - `vehicleprofile` string, nullable: The vehicle profile type (car, truck, bicycle, flying_distance).
    - `minordersperroute` integer, nullable: Minimum number of orders per route.
    - `parkingtime` number, nullable: Parking time at order locations (in hours).
  - `courierids` string[], required: The couriers of the vehicle.

## Other responses

- `422`: Unprocessable Content

---

[API](https://skmtc.dev/nash/apis/nash-api.md) - [All operations](https://skmtc.dev/nash/apis/nash-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nash/apis/nash-api/revisions/e3713837c5c9?raw)