Roamify eSIM APIs
Home
Roamify Docs
Home
Roamify Docs
  1. Orders
  • eSIM Country
    • Get eSIM Supported Country
      GET
  • eSIM Packages
    • Get eSIM Packages
      GET
  • Orders
    • Create eSIM Order
      POST
    • Create eSIM Top-Up Order
      POST
    • Create Instant eSIM Order (no /apply needed)
      POST
    • Get all eSIM Orders
      GET
    • Get Order
      GET
  • eSIMs
    • Generate eSIM Profile
      POST
    • Get eSIM Usage
      GET
    • Get eSIM Usage Details
      GET
    • Get eSIM Events
      POST
    • Get eSIM Compatible TopUp Packages
      GET
    • Get eSIM Packages History
      GET
    • Get eSIM
      GET
    • Get eSIMs
      GET
    • Generate eSIMs Link for Sharing
      POST
  • Compatible Devices
    • Get eSIM Compatible Devices
      GET
  • Account Balance
    • Get Account Balance
      GET
  • Exchange Rates
    • Get Supported Currencies
      GET
    • Get Exchange Rate
      GET
  • Gift Cards
    • Update Gift Card
      PUT
    • Revoke Gift Card
      PUT
    • Create Gift Card
      POST
    • Get all Gifts
      GET
    • Get Gift
      GET
  • Health Check
    • API Health
Home
Roamify Docs
Home
Roamify Docs
  1. Orders

Create eSIM Top-Up Order

Development
https://api-dev.getroamify.com
Development
https://api-dev.getroamify.com
POST
https://api-dev.getroamify.com
/api/esim/order/topup
Last modified:2025-09-03 22:19:51
Maintainer:Not configured
To create a top-up order, you need to send a POST request to the /api/esim/order/topup endpoint.
You are required to provide the following parameters in the request body:
iccid: The ICCID of the eSIM you want to top-up. This is a required field of type string.
packageId: The ID of the eSIM package you want to top-up. This is a required field of type string.

Request

Header Params

Body Params application/json

Example
{
	"iccid": "894000000000039210",
	"packageId": "esim-cambodia-7days-1gb-all"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-dev.getroamify.com/api/esim/order/topup' \
--header 'Authorization: Bearer roamify_4T7vL2C981JaPAzF9mZ7tbbNABiCQMPQF5yHkJjiFfj1gjQrJEnncBCDNt4MTsCP4J3X1bfZedHKekMpzyv9LLWY3AaED3L6aPY38ZDoPdvCDbLju7CwjF2JRNXbfhp9VbRAZo2QCFwFBFgipP97EGqNGHpWqPBsiWu4SaBhV3CUSvDrK9LWE4SRG' \
--header 'Content-Type: application/json' \
--data-raw '{
	"iccid": "894000000000039210",
	"packageId": "esim-cambodia-7days-1gb-all"
}'

Responses

🟢200successfully / 200
text/plain
Example
application/json; charset=utf-8 content type is not supported in the response body
Modified at 2025-09-03 22:19:51
Previous
Create eSIM Order
Next
Create Instant eSIM Order (no /apply needed)
Built with