llms.txt
# Vignette ID
> Vignette ID is a multi-country platform for purchasing electronic road toll vignettes (e-vignettes), tunnel passes, bridge tolls, and ferry tickets across 9 European countries. One API, one integration — access to road payments in Austria, Switzerland, Slovenia, Hungary, Slovakia, Czech Republic, Romania, Bulgaria, and Moldova.
Vignette ID provides a Partner API that enables businesses to integrate e-vignette purchasing into their own applications. The API supports real-time product catalog with pricing, vehicle plate validation, order creation with instant digital delivery, and order management. All vignettes are officially registered with national government providers.
Supported product types: vignettes, tunnel passes (Austria, Switzerland), bridge tolls, train tickets, ferry tickets.
Supported vehicle types: car (≤3.5T), van, motorcycle.
Available periods vary by country: 1 day, 10 days, 30 days, 1 year (country-specific).
Supported currencies: EUR, USD, UAH, PLN, HUF, and more.
Authentication: Bearer token (API key).
Base URL: https://api.vignette.id
MCP Server: https://api.vignette.id/mcp
## API Documentation
- [Partner API Reference](https://docs.vgnt.app/api): Full API documentation with endpoints, schemas, and examples
- [API Home](https://docs.vgnt.app/home): Overview and partnership information
- [Covered Countries](https://docs.vgnt.app/vignettes/vignette-covered-countries): Detailed country-by-country vignette rules and validity periods
- [OpenAPI Specification](https://vignette.id/openapi.yaml): Machine-readable API specification
## Core API Endpoints
- [GET /public/products](https://docs.vgnt.app/api/products-list-endpoints): Retrieve all available vignettes, tunnels, bridges, trains, and ferries with real-time pricing. Filter by country, type, vehicle_type, and currency.
- [GET /public/products/status](https://docs.vgnt.app/api/products-list-endpoints): Check national provider status (online/offline) and product availability.
- [POST /public/orders](https://docs.vgnt.app/api/orders-list-endpoints): Create a new vignette order. Supports pre-paid orders and payment link generation.
- [GET /public/orders](https://docs.vgnt.app/api/orders-list-endpoints): List all partner orders with filtering by status.
- [GET /public/orders/{id}](https://docs.vgnt.app/api/orders-list-endpoints): Retrieve specific order details by Vignette ID or partner custom_id.
- [GET /public/orders/{id}/status](https://docs.vgnt.app/api/orders-list-endpoints): Quick order status check.
- [POST /public/orders/{id}/cancel-pending](https://docs.vgnt.app/api/orders-list-endpoints): Cancel a pending order.
- [POST /public/orders/{id}/cancel-deferred](https://docs.vgnt.app/api/orders-list-endpoints): Cancel a deferred order.
- [POST /public/validate-vehicle](https://docs.vgnt.app/api/extended-list-endpoints): Validate vehicle registration plate for a specific country. Legacy — answers 400 on the first bad plate; also checks an optional email.
- [POST /public/vehicles/validate](https://docs.vgnt.app/api/extended-list-endpoints): Validate up to 20 registration plates, with a per-vehicle verdict, the normalized plate and whether that country supports VIN lookup.
- [GET /public/vehicles/lookup](https://docs.vgnt.app/api/extended-list-endpoints): Resolve a Ukrainian (ua) registration plate to its vehicle record — VIN code, brand, model, year, colour, body and fuel type, engine capacity, weights, category, registration date.
- [GET /public/vehicles/lookup/supported-countries](https://docs.vgnt.app/api/extended-list-endpoints): List the plate countries the vehicle lookup supports and the fields each one returns.
- [GET /public/vehicles/plate-rules](https://docs.vgnt.app/api/extended-list-endpoints): The plate validation rules as data (normalize → forbid → accept per country, accepted country codes, error types and messages) for validating in your own form; same verdicts as /vehicles/validate. ETag = version.
- [GET /public/vehicles/plate-rules/vectors](https://docs.vgnt.app/api/extended-list-endpoints): Conformance cases (plate, country, expected verdict) to test a client-side matcher built from the plate rules.
- [GET /public/locales](https://docs.vgnt.app/api/extended-list-endpoints): List the UI translation languages (ISO 639-1), how complete each is, and the table mapping API error codes to translation keys. ETag = version.
- [GET /public/locales/{language}](https://docs.vgnt.app/api/extended-list-endpoints): All UI strings for one language as flat dotted keys — the same translations vignette.id itself renders, so apps and partner frontends share one source. Accepts ISO, legacy and regional codes.
## Supported Countries
- Austria (at): 1-day, 10-day, 2-month, annual vignettes. Tunnel passes for [A9 Pyhrn](https://vignette.id/product/tunnel-at-a9), [A10 Tauern](https://vignette.id/product/tunnel-at-a10), [A11 Karawanken](https://vignette.id/product/tunnel-at-a11), [A13 Brenner](https://vignette.id/product/tunnel-at-a13), [S16 Arlberg](https://vignette.id/product/tunnel-at-s16). Car: [vignette-at-2a](https://vignette.id/product/vignette-at-2a).
- Switzerland (ch): Annual vignette. Car: [vignette-ch-2a](https://vignette.id/product/vignette-ch-2a).
- Slovenia (si): 7-day, 30-day, annual vignettes. Car: [vignette-si-2a](https://vignette.id/product/vignette-si-2a).
- Hungary (hu): 1-day, 10-day, 30-day, annual vignettes. Car: [vignette-hu-2a](https://vignette.id/product/vignette-hu-2a).
- Slovakia (sk): 1-day, 10-day, 30-day, annual vignettes. Car: [vignette-sk-2a](https://vignette.id/product/vignette-sk-2a).
- Czech Republic (cz): 1-day, 10-day, 30-day, annual vignettes. Car: [vignette-cz-2a](https://vignette.id/product/vignette-cz-2a).
- Romania (ro): 1-day, 7-day, 30-day, 90-day, annual vignettes. VIN code required for periods >1 day. Car: [vignette-ro-2a](https://vignette.id/product/vignette-ro-2a).
- Bulgaria (bg): Weekend, 7-day, 30-day, 90-day, annual vignettes. Car: [vignette-bg-2a](https://vignette.id/product/vignette-bg-2a).
- Moldova (md): 7-day, 15-day, 30-day vignettes. VIN, passport data required. Car: [vignette-md-2a](https://vignette.id/product/vignette-md-2a).
## Policies
- [Terms of Service](https://vignette.id/legal/terms)
- [Privacy Policy](https://vignette.id/legal/privacy)
## Partnership
- [Become a Partner](https://e-vignettes.eu/en/partner): Register for API sandbox access
- [Contact](mailto:work@vignette.id): Partnership and support inquiries
## Optional
- [Mobile App (iOS)](https://apps.apple.com/app/vignette-id/id1234567890): Vignette ID app for iPhone
- [Mobile App (Android)](https://play.google.com/store/apps/details?id=app.vignette.id): Vignette ID app for Android
- [LinkedIn](https://www.linkedin.com/company/vignetteid): Company updates
