Create Instant eSIM Order (no /apply needed)

Development

https://api-dev.getroamify.com

POST

/api/esim/order/instant

Last modified:2026-01-07 20:58:13

Maintainer:Not configured

To create an instant eSIM order, you need to send a POST request to the /api/esim/order/instant endpoint.

- Please make sure you have timeout set to at least `60 seconds` to use this endpoint.(Depends on what you order, the fulfillment time can varies)
- There is no need to call /apply endpoint with this endpoint

You are required to provide the following parameters in the request body:

items: An array of eSIM items you want to order. Each item should contain the following details:

packageId: The ID of the eSIM package you want to order. This is a required field of type string.

quantity: The quantity of the eSIM package you want to order. This is a required field of type number.

referenceId: The reference ID for the order. This is an optional field of type string. (Your custom reference ID for the order, if needed.)

Request

Header Params

Body Params application/json

Example

{
	"items": [
		{
			"packageId": "esim-cambodia-7days-1gb-all",
			"quantity": 1
		}
	],
	// "referenceId": "partner reference id(optional)"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-dev.getroamify.com/api/esim/order/instant' \
--header 'Authorization: Bearer roamify_4T7vL2C981JaPAzF9mZ7tbbNABiCQMPQF5yHkJjiFfj1gjQrJEnncBCDNt4MTsCP4J3X1bfZedHKekMpzyv9LLWY3AaED3L6aPY38ZDoPdvCDbLju7CwjF2JRNXbfhp9VbRAZo2QCFwFBFgipP97EGqNGHpWqPBsiWu4SaBhV3CUSvDrK9LWE4SRG' \
--header 'Content-Type: application/json' \
--data-raw '{
	"items": [
		{
			"packageId": "esim-cambodia-7days-1gb-all",
			"quantity": 1
		}
	],
	// "referenceId": "partner reference id(optional)"
}'

Responses

🟢200successfully / 200

text/plain

Example

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

Modified at 2026-01-07 20:58:13

Create eSIM Top-Up Order

Get all eSIM Orders