Vehicle Categories

Retrieve vehicle categories used when purchasing vignette tickets. Each vignette product is associated with a specific vehicle category, and orders for vignettes reference a vehicleCategoryId.

List Vehicle Categories

text

GET /products/vehicle-categories

API key only, no signature required.

Query Parameters

Name	Type	Required	Description
`language`	string	No	Localized names language code (e.g., `en`, `de`, `tr`)

Unknown query parameters are rejected with a 400 (strict validation). There is no includeVehicles parameter on the partner surface.

Example Request

GET/v2/partners/products/vehicle-categories

curl "https://api.vignetim.com/v2/partners/products/vehicle-categories" \
  -H "X-API-Key: $VIGNETIM_API_KEY"

Response

json

{
	"data": [
		{
			"id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
			"name": "Car (up to 3.5t)",
			"localizedName": "PKW (bis 3,5t)",
			"categoryTypeId": 1,
			"vehicleCategoryExplanations": 1,
			"typeId": 1,
			"parentVehicleTypeId": 0,
			"lengthTypeId": 1,
			"weightTypeId": 1,
			"heightTypeId": 1,
			"emissionClassId": 0,
			"axlesTypeId": 1,
			"seatTypeId": 1,
			"wheelbaseTypeId": 0,
			"iconTypeId": 3,
			"withTrailer": false
		}
	],
	"metadata": {
		"total": 24,
		"environment": "LIVE"
	}
}

Vehicle Category Object

Field	Type	Description
`id`	UUID	Vehicle category ID (used in tickets and orders)
`name`	string	Category name
`localizedName`	string	Localized name, present when `language` is requested
`categoryTypeId`	integer	Category type ID
`vehicleCategoryExplanations`	integer	Explanation set ID
`typeId`	integer	Vehicle type ID
`parentVehicleTypeId`	integer	Parent vehicle type ID
`lengthTypeId`	integer	Length classification ID
`weightTypeId`	integer	Weight classification ID
`heightTypeId`	integer	Height classification ID
`emissionClassId`	integer	Emission class ID
`axlesTypeId`	integer	Axle count classification ID
`seatTypeId`	integer	Seat count classification ID
`wheelbaseTypeId`	integer	Wheelbase classification ID
`iconTypeId`	integer	Icon type ID
`withTrailer`	boolean	Whether the category includes a trailer

Get Vehicle Categories by Type

text

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

Path Parameters

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

Query Parameters

Same as the list endpoint (language).

Example Request

GET/v2/partners/products/vehicle-categories/by-type/1

curl "https://api.vignetim.com/v2/partners/products/vehicle-categories/by-type/1" \
  -H "X-API-Key: $VIGNETIM_API_KEY"

Response

Same object shape as the list endpoint:

json

{
	"data": [
		{
			"id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
			"name": "Car (up to 3.5t)",
			"categoryTypeId": 1,
			"vehicleCategoryExplanations": 1,
			"typeId": 1,
			"parentVehicleTypeId": 0,
			"lengthTypeId": 1,
			"weightTypeId": 1,
			"heightTypeId": 1,
			"emissionClassId": 0,
			"axlesTypeId": 1,
			"seatTypeId": 1,
			"wheelbaseTypeId": 0,
			"iconTypeId": 3,
			"withTrailer": false
		}
	],
	"metadata": {
		"total": 6,
		"environment": "LIVE"
	}
}