---
title: "Add Vehicle"
method: POST
path: "/business/v2/vehicles"
tags: ["Vehicles"]
---

# Add Vehicle

`POST /business/v2/vehicles`

## Request

- Base URL: `https://api.soldo.com`
- URL: `https://api.soldo.com/business/v2/vehicles`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.soldo.com/oauth/authorize` scopes: `vehicle_write`
- TypeScript: <https://skmtc.dev/soldo/apis/soldo-business-api-v2-0/docs/business/v2/vehicles/post.ts> (a function with typed inputs; its response is checked against the schema)

Endpoint to add a new `Vehicle`.

## Request body

- CreateVehicle: Create `Vehicle` JSON parameters.
  - `number_plate` string, required: The plate number of the `Vehicle`.
  - `description` string, required: The description of the `Vehicle`.
  - `vat_deductible` 'NONE' | '40' | '80' | '100', required
  - `fuel_type` 'PETROL' | 'DIESEL' | 'METHANE' | 'LPG' | 'LNG' | 'ELECTRIC' | 'UNKNOWN', required
  - `reimbursement_rate` number: The rate to apply for a `MileageReimbursement`, measured in main `Wallet` currency per km.
  - `mileage` integer: The mileage of the `Vehicle`, measured in km.

## Response `200`

The returned resource is a new `Vehicle`.

- Vehicle
  - `id` string: The `Vehicle` ID (sortable: no).
  - `number_plate` string: The plate number of the `Vehicle` (sortable: yes).
  - `description` string: The description of the `Vehicle` (sortable: no).
  - `vat_deductible` 'NONE' | '40' | '80' | '100'
  - `fuel_type` 'PETROL' | 'DIESEL' | 'METHANE' | 'LPG' | 'LNG' | 'ELECTRIC' | 'UNKNOWN'
  - `status` 'ACTIVE' | 'ARCHIVED'
  - `creation_time` string: The date and time when the `Vehicle` was created (sortable: yes).
  - `last_update_time` string: The last date and time when the `Vehicle` was updated (sortable: yes).
  - `card_ids` string[]: The list of `Card` ID associated with the `Vehicle` (sortable: no).
  - `reimbursement_rate` number: The rate to apply for a `MileageReimbursement`, measured in main `Wallet` currency per km (sortable: no).
  - `mileage` integer: The latest mileage of the `Vehicle`, measured in km, either manually registered or automatically updated after a `Refueling` transaction (sortable: no).

## Other responses

- `400`: Your request has missing arguments or is malformed.

## Changes

- **2026-09-05** `4c2f28426f74`: 1 warning, 3 info
  - changed the pattern of the request property `description` from `^[^<>=]{0,30}$` to `^[^<>=]{0,255}$`
  - added the new optional request property `mileage`
  - the `description` request property's maxLength was increased from `30` to `255`
  - added the optional property `mileage` to the response with the `200` status
- **2026-05-10** `281d6e1cd633`: 2 info
  - added the new optional request property `reimbursement_rate`
  - added the optional property `reimbursement_rate` to the response with the `200` status

[Operation history](https://skmtc.dev/soldo/apis/soldo-business-api-v2-0/changes/business/v2/vehicles/post.md)

---

[API](https://skmtc.dev/soldo/apis/soldo-business-api-v2-0.md) - [All operations](https://skmtc.dev/soldo/apis/soldo-business-api-v2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/soldo/apis/soldo-business-api-v2-0/revisions/23fc5d07b367?raw)