List vehicles

This endpoint documentation is generated directly from `openapi.yaml`.

Endpoint

GET /vehicles

Operation

Operation ID: `listVehicles`

List vehicles or fetch a specific vehicle when `id` is provided.

- When `id` is present, returns a single vehicle object (404 if not found). - Otherwise returns a paginated list of vehicles.

Permissions: - Own scope: `list_own_vehicles` (linked to subuser node `VEHICLES_LIST`). - Broader scope: `list_vehicles_other`.

Subusers may specify header `X-Customer-Number` to target a specific customer. If the broader permission is missing, the list will automatically be restricted to the effective customer context.

Authentication

Security requirements:

Scheme | Scopes
BearerAuth | -

Parameters

Name | In | Required | Type | Description
|  | no | object |
id | query | no | integer |
reg | query | no | string |
customer_id | query | no | integer |

Responses

Status | Description | Content Types
200 | Vehicle(s) retrieved successfully | application/json
403 |  |
404 |  |

Schema for response `200` (`application/json`):

{ "oneOf": [ { "$ref": "#/components/schemas/Vehicle" }, { "items": { "$ref": "#/components/schemas/Vehicle" }, "type": "array" } ] }