---
title: "List vehicles"
method: GET
path: "/v1/locations/{locationId}/vehicles"
tags: ["Vehicles"]
---

# List vehicles

`GET /v1/locations/{locationId}/vehicles`

## Request

- Base URL: `https://api.cliento.com`
- URL: `https://api.cliento.com/v1/locations/{locationId}/vehicles`
- Auth: HTTP bearer

The location's vehicles, oldest first, one page at a time. To find one, filter on its registration number or your own reference.

## Path parameters

- `locationId` string, required

## Query parameters

- `registrationNumber` string
- `externalReference` string
- `limit` integer
- `after` string

## Response `200`

OK

- VehicleList
  - `data` Vehicle[], required
    - `colour` string: From the vehicle register.
    - `createdAt` string, date-time
    - `description` string: What the vehicle is called in Cliento. A lookup in the vehicle register fills it in with the make, model, colour and year; staff can change it.
    - `externalReference` string: Your own id for it, as sent when it was created.
    - `id` string, required
    - `locationId` string, required
    - `make` string: From the Swedish vehicle register, when staff have looked the vehicle up in Cliento. Not set through the API.
    - `model` string: From the vehicle register.
    - `modelYear` integer: From the vehicle register.
    - `notes` string: Staff-facing notes, at most 1000 characters.
    - `registrationNumber` string: The registration number, one to seven characters.
    - `updatedAt` string, date-time
  - `nextCursor` string: Pass as `after` to fetch the next page. Absent on the last page.

## Other responses

- `default`: Any failure. See the Errors section.

---

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