Create eSIM Top-Up Order

Development

https://api-dev.getroamify.com

POST

/api/esim/order/topup

Last modified:2026-06-09 17:13:47

Maintainer:Not configured

Creates a top-up order for an existing eSIM, adding more data or extending validity.

Tip: Before creating a top-up order, call GET /api/esim/topup/packages to retrieve the list of compatible packages for the eSIM.

Body Parameters

Name	Type	Required	Description
`iccid`	`string`	required	The ICCID of the eSIM to top up.
`packageId`	`string`	required	The ID of the package to apply. Retrieve compatible packages from the Get eSIM Compatible TopUp Packages endpoint.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200successfully / 200

text/plain

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-dev.getroamify.com/api/esim/order/topup' \
--header 'Authorization: Bearer roamify_3fegvaRHZxZoAsB7Yg5KFs5ymSg3kBN1trn4DxRrqW1mDRoo9DueN6FSfNTuGndVGpR2iTyH4UVmZf39tVb5muWUPqBm1dh5eHiH5WkPN3wGLF8cr7MhemqekwK7rdqFizTZD9VDRq5P5RHAXzL2tCHfcrsskg2YoP8JE1fndNoiQCUSS1GBUUpmH' \
--header 'Content-Type: application/json' \
--data '{
	"iccid": "894000000000039210",
	"packageId": "esim-cambodia-7days-1gb-all"
}'

Response Example

application/json; charset=utf-8 content type is not supported in the response body

Modified at 2026-06-09 17:13:47

Create eSIM Order

Create Instant eSIM Order (no /apply needed)

Create eSIM Top-Up Order

Body Parameters#

Request

Responses

Body Parameters