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_4ECge13m8ZqFvGshLVLfdnFzi5hGuXkCBg2keWxVVKi7b2BGWmoXiv7bgVtNxY5Ruif7QKEthrLNrEkvnBV3Z7D3Fyj547NbnDnsDU7HgkRX8ggKD285dkXZHdNFM8npxoyr12nSzfpzqRuLvJj2d9eXgucEQmD9Gg4aKnUWvNaRbz1mKv7fAwdJe' \
--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