### Copenhagen Truck Wash API Help

# 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" } ] }
17 March 2026