Get top-up package list

GET

/customer/v2/sims/{iccid}/topups

Endpoint do support new type of packages - "Voice and Text"
To get the list of available packages for an eSIM:

Make a GET request to the endpoint URL: v1/sims/:iccid/topups, replace :iccid with the ICCID of the eSIM for which you want to purchase a top-up.

The API will respond with a JSON object containing an array of available top-up packages, each of which includes an ID, price, data amount, duration, and other information.

Request

Path Params

Header Params

Responses

🟢200eSIM: List available top-up packages: 200 OK

application/json

Body

🟢200eSIM: List available top-up packages: 200 (No top-up packages available)

🟢200eSIM: List available top-up packages: 404 (Invalid ICCID)

🟠422eSIM: List available top-up packages: (Recycled Sim Response 422)

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://prod.your-api-server.com/customer/v2/sims/8910300000005271146/topups' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{token}}'

Response Example

200 - eSIM: List available top-up packages: 200 OK

{
    "data": [
        {
            "id": "bonbon-mobile-30days-3gb-topup",
            "type": "topup",
            "price": 10,
            "amount": 3072,
            "day": 30,
            "is_unlimited": false,
            "title": "3 GB - 100 SMS - 100 Mins - 30 Days",
            "data": "3 GB",
            "short_info": "This eSIM doesn't come with a phone number.",
            "voice": 100,
            "text": 100
        },
        {
            "id": "bonbon-mobile-30days-5gb-topup",
            "type": "topup",
            "price": 15,
            "amount": 5120,
            "day": 30,
            "is_unlimited": false,
            "title": "5 GB - 30 Days",
            "data": "5 GB",
            "short_info": "This eSIM doesn't come with a phone number.",
            "voice": 100,
            "text": 100
        },
        {
            "id": "bonbon-mobile-30days-10gb-topup",
            "type": "topup",
            "price": 22.5,
            "amount": 10240,
            "day": 30,
            "is_unlimited": false,
            "title": "10 GB - 30 Days",
            "data": "10 GB",
            "short_info": "This eSIM doesn't come with a phone number.",
            "voice": 100,
            "text": 100
        }
    ]
}

Modified at 2025-11-17 07:46:20

Get usage (data, text & voice)

Submit top-up order