*REST API › Objects › Operations*

# Vehicle

> Fleet vehicle.

A vehicle of the delivery fleet, with its registration, seats, payload, inspection date and collection. The cost per kilometer and the fixed cost are not part of the public contract. Vehicles are bounded to the subscription that owns the key.

Schemas: `VehicleDto`

## Attributes

| Name | Type | Description |
| --- | --- | --- |
| `id` | string | Unique vehicle identifier. |
| `name` | string | Vehicle name. |
| `status` | string | Operational status: active (available), maintenance (in the workshop) or inactive (out of service). `active`, `maintenance`, `inactive` |
| `registrationNumber` | string | Registration number; null if not recorded. |
| `seats` | number | Seats, including the driver seat; null if not recorded. |
| `payloadKg` | number | Payload in kilograms; null if not recorded. |
| `inspectionDate` | string<date-time> | Date of the next technical inspection in ISO 8601 UTC; null if not recorded. |
| `collectionId` | string | Identifier of the collection it belongs to; null if it is in none. |
| `collectionName` | string | Collection path; null if not applicable. |
| `showInPlanner` | boolean | true if it appears in the planner of the account. |
| `createdAt` | string<date-time> | Creation date in ISO 8601 UTC; null if not recorded. |
| `updatedAt` | string<date-time> | Last modification date in ISO 8601 UTC; null if not recorded. |

## Values

| Field | Values |
| --- | --- |
| `status` | `active`, `maintenance`, `inactive` |

## Example

*Vehicle · Generated from the schema*

```json
{
  "id": "id_8f2a1c",
  "name": "Example",
  "status": "active",
  "registrationNumber": "string",
  "seats": 1,
  "payloadKg": 1,
  "inspectionDate": "2026-09-01T08:00:00Z",
  "collectionId": "string",
  "collectionName": "Example",
  "showInPlanner": true,
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z"
}
```

## Returned by

- [`GET /api/v1/vehicles`](https://docs.filmo.io/rest-api/endpoint-reference/vehicles/list-vehicles) — List vehicles
- [`GET /api/v1/vehicles/{vehicleId}`](https://docs.filmo.io/rest-api/endpoint-reference/vehicles/get-a-vehicle) — Get a vehicle

## Modified by

- [`POST /api/v1/vehicles`](https://docs.filmo.io/rest-api/endpoint-reference/vehicles/create-a-vehicle) — Create a vehicle
- [`PATCH /api/v1/vehicles/{vehicleId}`](https://docs.filmo.io/rest-api/endpoint-reference/vehicles/update-a-vehicle) — Update a vehicle

---

Canonical URL: https://docs.filmo.io/rest-api/objects/vehicle  
Last updated: 2026-10-25