Geo Checkpoints

Retrieve geographic checkpoints such as toll gates, border crossings, and vignette control points. Checkpoints can be linked to the vignette tickets sold for that location, which lets you surface the right product when a customer plans a route.

List Checkpoints

text

GET /products/geo/checkpoints

API key only, no signature required.

Query Parameters

Name	Type	Required	Description
`country`	string	No	Two-letter country ISO code (e.g., `SI`)
`type`	string	No	Checkpoint type discriminator
`minLat`	number	No	Bounding box: minimum latitude
`maxLat`	number	No	Bounding box: maximum latitude
`minLng`	number	No	Bounding box: minimum longitude
`maxLng`	number	No	Bounding box: maximum longitude
`lang`	string	No	Language code for localized text
`page`	integer	No	Page number (default: 1)
`limit`	integer	No	Items per page (default: 50)

Example Request

GET/v2/partners/products/geo/checkpoints

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

Response

json

{
	"data": [
		{
			"id": "9a8b7c6d-5e4f-3210-fedc-ba0987654321",
			"countryIsocode": "SI",
			"type": "toll_gate",
			"latitude": 46.0569,
			"longitude": 14.5058,
			"title": {
				"en": "Ljubljana Ring Toll Point",
				"sl": "Cestninska tocka Ljubljana"
			},
			"description": {
				"en": "Vignette required beyond this point."
			},
			"infoText": {
				"en": "Applies to all vehicles up to 3.5t."
			},
			"iconType": "toll",
			"color": "#E53935",
			"productType": "ticket",
			"sortOrder": 10,
			"ticketIds": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"]
		}
	],
	"metadata": {
		"total": 87,
		"page": 1,
		"limit": 50,
		"totalPages": 2,
		"environment": "LIVE"
	}
}

Checkpoint Object

Field	Type	Description
`id`	UUID	Checkpoint ID
`countryIsocode`	string	Country the checkpoint belongs to
`type`	string	Checkpoint type discriminator (optional)
`latitude`	number	Latitude
`longitude`	number	Longitude
`title`	object	Localized title map keyed by locale code
`description`	object	Localized description map
`infoText`	object	Localized info text map (optional)
`iconType`	string	Icon hint for map rendering (optional)
`color`	string	Display color (optional)
`productType`	string	Related product type hint (optional)
`sortOrder`	integer	Suggested display ordering
`ticketIds`	string[]	IDs of vignette tickets sold for this checkpoint (optional)