Skip to main content
GET
Get eSIM Packages

Endpoint

Description

This endpoint returns eSIM packages available for a specific region. Prices are automatically calculated based on your account currency (NGN or USD).

Authentication

string
required
API Key for authentication

Query Parameters

string
required
Region code to filter packages (e.g., “US”, “EU”, “ASIA”)Get available region codes from /api/esim/regions
string
Package type filter:
  • BASE - New eSIM packages (default)
  • TOPUP - Top-up packages for existing eSIMs
string
Filter by region type:
  • LC - Local (single country)
  • RG - Regional (multi-country)
  • GL - Global
string
Specific package code to retrieve (required when type is TOPUP)

Response

array
Array of package objects with pricing

Example Request

Example Response

Package Types

Pricing

  • Prices are automatically converted to your account currency
  • NGN prices include the website’s price increment percentage
  • USD prices are shown for reference
  • All prices are final (no hidden fees)
Exchange rates and pricing increments are configured in your account settings

Use Cases

Show available packages in your UI:
Let users filter packages by their budget:
Display data top-up options for existing eSIMs:

Next Steps

Purchase eSIM

Buy an eSIM package

Get Package Details

Get detailed info for a specific package

Top Destinations

View popular destinations

Integration Guide

Build a package catalog UI