Vignette Tickets

Retrieve available highway vignette tickets. Vignettes are digital toll passes required for driving on motorways in various European countries.

All prices returned by this endpoint are your partner-specific effective prices (see Introduction for how pricing works). This is signalled by metadata.pricing: "effective".

List Tickets

text

GET /products/tickets

API key only, no signature required.

Query Parameters

Name	Type	Required	Description
`page`	integer	No	Page number (default: 1)
`limit`	integer	No	Items per page (default: 50, max: 100)
`countryIsocode`	string	No	Filter by country ISO code (e.g., `AT`, `CZ`, `CH`)
`vehicleCategoryId`	string	No	Filter by vehicle category UUID

Example Request

GET/v2/partners/products/tickets

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

Response

json

{
	"data": [
		{
			"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
			"countryIsocode": "AT",
			"name": "Austria 10-Day Vignette",
			"description": "Valid for 10 consecutive days on all Austrian motorways.",
			"displayName": {
				"en": "Austria 10-Day Vignette",
				"de": "Oesterreich 10-Tages-Vignette"
			},
			"typeId": 1,
			"ticketCategoryId": 2,
			"validDurationId": 3,
			"vehicleTypeId": 1,
			"vehicleCategoryId": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
			"endDateRuleId": 1,
			"price": 11.5,
			"ticketConditionsId": 1,
			"imageUrls": {
				"card": "https://cdn.vignetim.com/tickets/at-10d.png"
			}
		}
	],
	"metadata": {
		"total": 45,
		"page": 1,
		"limit": 50,
		"totalPages": 1,
		"environment": "LIVE",
		"pricing": "effective"
	}
}

Ticket Object

Field	Type	Description
`id`	UUID	Ticket product ID (use as `productId` when ordering)
`countryIsocode`	string	Country the vignette is valid in
`name`	string	Internal product name
`description`	string	Product description
`displayName`	object	Localized display names keyed by locale code
`typeId`	integer	Ticket type ID
`ticketCategoryId`	integer	Ticket category ID
`validDurationId`	integer	Validity duration ID
`vehicleTypeId`	integer	Vehicle type ID
`vehicleCategoryId`	UUID	Vehicle category ID (optional)
`endDateRuleId`	integer	Rule for computing the validity end date
`price`	number	Your effective price (EUR)
`ticketConditionsId`	integer	Conditions document ID
`imageUrls`	object	Product image URLs (optional)

Get Ticket by ID

text

GET /products/tickets/:id

Path Parameters

Name	Type	Required	Description
`id`	UUID	Yes	The ticket product ID

Example Request

GET/v2/partners/products/tickets/a1b2c3d4-e5f6-7890-abcd-ef1234567890

curl "https://api.vignetim.com/v2/partners/products/tickets/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "X-API-Key: $VIGNETIM_API_KEY"

Response

Returns a single bare ticket object (no data/metadata envelope), with the same fields as the list items:

json

{
	"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
	"countryIsocode": "AT",
	"name": "Austria 10-Day Vignette",
	"description": "Valid for 10 consecutive days on all Austrian motorways.",
	"displayName": { "en": "Austria 10-Day Vignette" },
	"typeId": 1,
	"ticketCategoryId": 2,
	"validDurationId": 3,
	"vehicleTypeId": 1,
	"vehicleCategoryId": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
	"endDateRuleId": 1,
	"price": 11.5,
	"ticketConditionsId": 1
}