Skip to main content
GET
/
api
/
v1
/
esim
/
packages
eSIM packages for region
curl --request GET \
  --url https://api.dancity.app/api/v1/esim/packages \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "Packages fetched",
  "data": [
    {
      "packageCode": "NG-1GB-7D",
      "name": "Nigeria 1GB 7 Days",
      "dataAmount": "1GB",
      "validity": "7 days",
      "price": 3000
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Merchant API key from the Dancity dashboard.

Query Parameters

​
regionCode
string
required

Region code from GET /api/v1/esim/regions (e.g. NG for Nigeria, EU-42 for a multi-country region).

Example:

"NG"

​
regionType
enum<string>
default:country

Region classification from the regions list — pass the selected region's type value. country = single country (default), multi-country = regional bundle covering multiple countries.

Available options:
country,
multi-country,
global
Example:

"country"

​
type
enum<string>
default:BASE

Package category: BASE = new eSIM to install, TOPUP = add data to an existing eSIM. Defaults to BASE.

Available options:
BASE,
TOPUP
Example:

"BASE"

Response

OK