Get eSIM Packages

Returns a paginated list of eSIM data packages. All parameters are optional — omitting them returns all packages. Use combinations of filters to narrow results by geography, validity, data size, or a specific package ID.

Query Parameters

Name	Type	Required	Description
`country`	`string`	optional	Full country name. Retrieve the accepted value from the `name` field in the eSIM Country API.
`countryCode`	`string`	optional	ISO country code. Retrieve the accepted value from the `code` field in the eSIM Country API. Can be used instead of or alongside `country`.
`days`	`number`	optional	Filter by eSIM validity period in days.
`gbs`	`number`	optional	Filter by data allowance in gigabytes. Ignored when `isUnlimited` is `true`.
`geography`	`string`	optional	Scope of coverage for the package. Accepted values: `local`, `regional`, `global`.
`isUnlimited`	`boolean`	optional	When `true`, returns only unlimited data plans. When `false` or omitted, all plans are returned.
`packageId`	`string`	optional	Fetch a specific package by its unique identifier. When provided, all other filters are typically ignored.
`page`	`string`	optional	Page number for paginated results. Defaults to `1` if omitted.
`pageSize`	`string`	optional	Number of results per page. Defaults to `50`.

Country lookup: Both code and name values must come from the eSIM Country API response — arbitrary strings are not accepted. Call that endpoint first to obtain valid identifiers.

curl --location 'https://api-dev.getroamify.com/api/esim/packages' \ --header 'Authorization: Bearer roamify_4ECge13m8ZqFvGshLVLfdnFzi5hGuXkCBg2keWxVVKi7b2BGWmoXiv7bgVtNxY5Ruif7QKEthrLNrEkvnBV3Z7D3Fyj547NbnDnsDU7HgkRX8ggKD285dkXZHdNFM8npxoyr12nSzfpzqRuLvJj2d9eXgucEQmD9Gg4aKnUWvNaRbz1mKv7fAwdJe'

Query Parameters

Request

Responses

Get eSIM Packages

Query Parameters#

Request

Responses

Query Parameters