eSIM Packages

Retrieve available eSIM mobile data packages for travelers.

All prices returned by this endpoint are your partner-specific effective prices, signalled by metadata.pricing: "effective".

List eSIM Packages

text

GET /products/esim

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)
`country`	string	No	Filter by country ISO code (e.g., `TR`, `DE`, `US`)
`slug`	string	No	Filter by package slug identifier

Example Request

GET/v2/partners/products/esim

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

Response

json

{
	"data": [
		{
			"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
			"slug": "turkey-5gb-30days",
			"planType": "data",
			"dataLabel": "5GB",
			"day": 30,
			"price": 12.99,
			"imageUrl": "https://cdn.vignetim.com/esim/turkey-5gb.png"
		},
		{
			"id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
			"slug": "europe-10gb-30days",
			"planType": "data",
			"dataLabel": "10GB",
			"day": 30,
			"price": 24.99
		}
	],
	"metadata": {
		"total": 128,
		"page": 1,
		"limit": 50,
		"totalPages": 3,
		"environment": "LIVE",
		"pricing": "effective"
	}
}

eSIM Package Object

Field	Type	Description
`id`	string	Package ID (use as `productId` when ordering)
`slug`	string	URL-safe package identifier
`planType`	string	Plan type (e.g., `data`)
`dataLabel`	string	Human-readable data amount (e.g., `5GB`, `Unlimited`)
`day`	integer	Validity in days
`price`	number	Your effective price (EUR)
`imageUrl`	string	Package image URL (optional)

The response does not say whether a package covers a single country, a region or the whole world. planType is the provider's service marker (data, data-voice-text), not a coverage scope — a country package and a regional one both report data. Today the only signal is slug, which is the destination name (bulgaria, europe, world). Filter by country when you need packages that cover a specific market.