---
title: "Returns a specific vehicle"
method: GET
path: "/vehicles/{vehicleId}"
tags: ["Vehicles"]
---

# Returns a specific vehicle

`GET /vehicles/{vehicleId}`

## Path parameters

- `vehicleId` integer, required

## Response `200`

Vehicle

- object
  - `data` Vehicle — Available relations: assignments, unarchived_assignments, archived_assignments, picture, changelog
    - `id` integer
    - `first_line` string — First line
    - `icon` string — Icon
    - `color` string — Color
    - `contrast_color` 'dark' | 'white' — Contrast color
    - `custom_number` string — Custom number
    - `picture_is_avatar` boolean — Picture is avatar
    - `picture_id` integer — Photo
    - `manufacturer` string — The manufacturer of the vehicle
    - `model` string — The model of the vehicle
    - `registration_number` string — The registration number of the vehicle
    - `license_plate` string — The license plate of the vehicle
    - `date_of_purchase` string, date — The date of purchase
    - `next_maintenance` string, date-time — The date of next maintenance
    - `mot_expires` string, date-time — The date when MOT expires
    - `condition` 'NEW' | 'USED' | 'LEASED' | 'DEFECT' | 'SORTED_OUT' — The condition of the vehicle
    - `info` string — Additional information about the vehicle
    - `reminded_mot_expires` boolean — Whether the user was reminded about MOT expiration
    - `source` string — The source of the vehicle data
    - `source_external_id` string, nullable — The external ID from the source
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401` — The request lacks valid authentication credentials.
- `403` — The token is valid but lacks the permission for this action.
- `404` — The requested resource could not be found.
- `500` — An unexpected error occurred on the server (e.g. a requested relation does not exist).

---

[API](https://skmtc.net/craftboxx/apis/craftboxx-api-documentation.md) · [All operations](https://skmtc.net/craftboxx/apis/craftboxx-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/craftboxx/craftboxx-api-documentation/versions/c01f07a02f77/schema)