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
		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"
    }
  ]
}
        

17 March 2026