Get Offers

Returns available products and prices

Endpoint

POST /v1/get-offers

Returns available products and prices. One request targets one product. The price in every offer is the final price in MDL (partner margin already included). min_start_date is the earliest start date you may use, in yyyy-mm-dd format.

Body Parameters

Available products: vignette:ro, vignette:md, vignette:eu.

1. Vignette (RO)

Romania road vignette (rovinietă), priced from a vehicle certificate.

Request Body Examples

Name	Type	Required	Description
`product`	`string`	yes	Product `vignette:ro`
`vehicle`	`string`	yes	Vehicle Certificate Number (9 digits)

{
  "product": "vignette:ro",
  "vehicle": "123456789" // 9 digits certificate number
}

Response Body Examples

Multiple duration tiers are returned; duration is in days, category is the RO vehicle category, and max_interval is the max selectable interval in days.

{
  "offers": [
    {
      "product": "vignette:ro",
      "category": "A",
      "duration": 1,
      "max_interval": 30,
      "name": "1 zile, (A-Autoturisme), HONDA CIVIC CHY999",
      "external_category": "A",
      "reference_price": "12.44 RON",
      "reference_exchange_rate": "1 RON 4.6302 MDL",
      "price": 57.6,
      "currency": "MDL",
      "min_start_date": "2024-06-25", // yyyy-mm-dd format
      "message": "Pentru vehicul categorie A nr.inmatriculare TTC659, exista rovinieta activa in perioada 03.07.2025 - 12.07.2025"
    },
    {
      "product": "vignette:ro",
      "category": "A",
      "duration": 10,
      "max_interval": 30,
      "name": "10 zile, (A-Autoturisme), HONDA CIVIC CHY999",
      "external_category": "A",
      "reference_price": "16.42 RON",
      "reference_exchange_rate": "1 RON 4.4549 MDL",
      "price": 73.15,
      "currency": "MDL",
      "min_start_date": "2024-06-25", // yyyy-mm-dd format
      "message": "Pentru vehicul categorie A nr.inmatriculare TTC659, exista rovinieta activa in perioada 03.07.2025 - 12.07.2025"
    }
  ]
}

2. Vignette (MD)

Moldova road vignette, priced from a validity period and vehicle category.

Request Body Examples

Name	Type	Required	Description
`product`	`string`	yes	Product `vignette:md`
`period`	`string`	yes	`Validity period`
`vehicle_category`	`string`	yes	`M1`, `M2`, `M3`, `N1`, `N2`, `N3`

Validity period by category:

M1: 7_days, 15_days, 30_days, 90_days, 180_days, >180_days
M2, M3, N1, N2, N3: 1_day, 7_days, 30_days, 90_days, 12_months

Vehicle category meanings:

M1 — Cars (vehicles classified under tariff heading 8703 and trailers attached to them)
M2 — Buses from 9 to 24 seats inclusive
M3 — Buses with more than 25 seats
N1 — Trucks / road tractors (with or without trailer/semi-trailer) up to and including 3.5 t
N2 — Trucks / road tractors from 3.5 to 10 t inclusive
N3 — Trucks / road tractors from 10 to 40 t inclusive

{
  "product": "vignette:md",
  "period": "7_days",
  "vehicle_category": "M1"
}

Response Body Examples

{
  "offers": [
    {
      "product": "vignette:md",
      "name": "Vinieta MD",
      "reference_price": "4.00 EUR",
      "reference_exchange_rate": "1 EUR 19.27 MDL",
      "price": 77.08,
      "currency": "MDL",
      "max_interval": 365,
      "min_start_date": "2024-06-25" // yyyy-mm-dd format
    }
  ]
}

3. Vignette (EU)

European multi-country vignette. A single request can return offers across every country you are allowed to sell, each tagged with its country and validity — pass both back to create-order. Prices are returned in MDL with the partner margin already included.

Identify the vehicle in one of two ways: by MD certificate (vehicle) to auto-derive the vehicle class, or by a foreign_vehicle descriptor for non-MD plates.

The human-readable labels (name, country_name, vehicle_class_info) default to Romanian. Pass the optional lang parameter (RO, EN or RU, case-insensitive) to receive them in another language. Any unrecognized value falls back to RO — lang never causes a request to be rejected.

Request Body Examples

Name	Type	Required	Description
`product`	`string`	yes	Product `vignette:eu`
`country`	`string`	no	ISO2 destination country (e.g. `ro`, `hu`, `bg`). Omit to receive all available countries
`vehicle`	`string`	no	MD vehicle certificate number — used to derive the vehicle class
`foreign_vehicle`	`object`	no	Foreign (non-MD) vehicle descriptor — use instead of `vehicle` for non-MD plates
`validity`	`string`	no	Validity option id to filter the response to a single option
`start_date`	`string`	no	Trip start date in yyyy-mm-dd format (defaults to today)
`lang`	`string`	no	Label language — `RO` (default), `EN`, `RU` (case-insensitive)

foreign_vehicle

Name	Type	Required	Description
`registration_country`	`string`	yes	ISO2 registration country (must not be `MD`)
`category`	`string`	yes	EU vehicle category (`M1`, `N1`, …)
`max_authorized_mass`	`number`	no	Max authorized mass in kg (used for tiered countries)
`places`	`number`	no	Number of seats (used for tiered countries)

{
  "product": "vignette:eu",
  "country": "bg",
  "vehicle": "123456789", // 9 digits certificate number
  "start_date": "2026-06-10"
}

{
  "product": "vignette:eu",
  "country": "bg",
  "foreign_vehicle": {
    "registration_country": "ua",
    "category": "M1"
  }
}

{
  "product": "vignette:eu",
  "country": "bg",
  "vehicle": "123456789",
  "lang": "EN"
}

Response Body Examples

validity is the option id you pass to create-order. vehicle_class (and vehicle_class_info) are only present for countries with tiered pricing (e.g. HU, SI).

{
  "offers": [
    {
      "product": "vignette:eu",
      "country": "bg",
      "country_name": "Bulgaria",
      "validity": "bg-7d",
      "duration": 7,
      "name": "Vinietă Europa - Bulgaria, 7 zile",
      "price": 179.15,
      "currency": "MDL",
      "reference_price": "8.82 EUR",
      "reference_exchange_rate": "1 EUR 19.27 MDL",
      "min_start_date": "2026-06-10" // yyyy-mm-dd format
    },
    {
      "product": "vignette:eu",
      "country": "hu",
      "country_name": "Ungaria",
      "validity": "hu-10d-d1",
      "duration": 10,
      "name": "Vinietă Europa - Ungaria, 10 zile",
      "vehicle_class": "D1",
      "vehicle_class_info": "Autoturisme (până la 7 locuri)",
      "price": 121.9,
      "currency": "MDL",
      "reference_price": "6.0 EUR",
      "reference_exchange_rate": "1 EUR 19.27 MDL",
      "min_start_date": "2026-06-10" // yyyy-mm-dd format
    }
  ]
}

With lang: "EN" the same offers return English labels. lang: "RU" returns Russian labels ("Болгария" / "Виньетка ЕС - Болгария, 7 дней"). Numeric fields are unchanged.

{
  "offers": [
    {
      "product": "vignette:eu",
      "country": "bg",
      "country_name": "Bulgaria",
      "validity": "bg-7d",
      "duration": 7,
      "name": "EU Vignette - Bulgaria, 7 days",
      "price": 179.15,
      "currency": "MDL",
      "reference_price": "8.82 EUR",
      "reference_exchange_rate": "1 EUR 19.27 MDL",
      "min_start_date": "2026-06-10" // yyyy-mm-dd format
    },
    {
      "product": "vignette:eu",
      "country": "hu",
      "country_name": "Hungary",
      "validity": "hu-10d-d1",
      "duration": 10,
      "name": "EU Vignette - Hungary, 10 days",
      "vehicle_class": "D1",
      "vehicle_class_info": "Passenger cars up to 3.5t with up to 7 seats",
      "price": 121.9,
      "currency": "MDL",
      "reference_price": "6.0 EUR",
      "reference_exchange_rate": "1 EUR 19.27 MDL",
      "min_start_date": "2026-06-10" // yyyy-mm-dd format
    }
  ]
}

Status Codes

Code	Description
`200`	Prices found
`400`	Bad request
`404`	Vehicle not found
`401`	Unauthorized
`403`	Forbidden
`500`	Internal server error