Vehicle Categories

Retrieve vehicle categories and types used when purchasing vignette tickets. Each vignette product is associated with a specific vehicle category.

List Vehicle Categories

GET /products/vehicle-categories

Query Parameters

Name	Type	Required	Description
`includeVehicles`	boolean	No	Include vehicle type details in the response (default: `false`)
`language`	string	No	Localized names language code (e.g., `en`, `de`, `tr`)

Response

{
	"data": [
		{
			"id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
			"name": "Car (up to 3.5t)",
			"description": "Passenger vehicles and motorhomes up to 3.5 tonnes",
			"typeId": 1,
			"vehicles": [
				{
					"id": "a1b2c3d4-0000-1111-2222-333344445555",
					"name": "Sedan",
					"icon": "car-sedan"
				},
				{
					"id": "a1b2c3d4-0000-1111-2222-333344446666",
					"name": "SUV",
					"icon": "car-suv"
				}
			]
		},
		{
			"id": "f2e3d4c5-b6a7-8901-bcde-f12345678901",
			"name": "Motorcycle",
			"description": "Two-wheeled motor vehicles",
			"typeId": 2,
			"vehicles": []
		},
		{
			"id": "f3e4d5c6-b7a8-9012-cdef-123456789012",
			"name": "Trailer (up to 3.5t)",
			"description": "Trailers with a maximum weight of 3.5 tonnes",
			"typeId": 3,
			"vehicles": []
		}
	]
}

The vehicles array is only populated when includeVehicles=true.

Get Vehicle Categories by Type

GET /products/vehicle-categories/by-type/:typeId

Path Parameters

Name	Type	Required	Description
`typeId`	integer	Yes	The vehicle type ID

Response

Returns vehicle categories filtered by the specified type ID, using the same response structure as the list endpoint.

{
	"data": [
		{
			"id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
			"name": "Car (up to 3.5t)",
			"description": "Passenger vehicles and motorhomes up to 3.5 tonnes",
			"typeId": 1,
			"vehicles": []
		}
	]
}