Skip to Content
🚀 Trusted by travel businesses worldwide - Roamify eSIM API
eSIMs ModuleCountries

eSIM API - Supported Countries

Table of Contents

Countries

To get a list of countries, you need to send a GET request to the /api/esim/countries endpoint.

There are no required parameters for this endpoint.

Optional query parameters:

  • geography: Filter countries by geography scope. Accepted values:
    • local
    • regional
    • global
⚠️

Use the returned name and code from this endpoint when querying /api/esim/packages. For package filters:

  • country must use name
  • countryCode must use code Arbitrary country strings are not accepted.

Usage - fetch a list of eSIM supported countries

Here is an example of how you can get a list of countries using Roamify eSIM API.

curl --request GET \
--url 'https://api-dev.getroamify.com/api/esim/countries' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json'

Usage - fetch countries by geography (optional)

curl --request GET \
--url 'https://api-dev.getroamify.com/api/esim/countries?geography=regional' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json'

Sample Response

{
	"status": "success",
	"data": {
		"countries": [
			{
				"code": "AF",
				"name": "Afghanistan",
				"geography": "local"
			},
			{
				"code": "AFR",
				"name": "Africa",
				"geography": "regional"
			},
			{
				"code": "AX",
				"name": "Åland Islands",
				"geography": "local"
			},
			{
				"code": "AL",
				"name": "Albania",
				"geography": "local"
			},
			{
				"code": "DZ",
				"name": "Algeria",
				"geography": "local"
			},
			{
				"code": "AD",
				"name": "Andorra",
				"geography": "local"
			}
        ]
    }
}
Last updated on
OverviewPackages