Recommended Batch Size
To stay within our rate-limiting, please do not exceed a quantity of 10 in a single order. Please also leave a minimum of three seconds between orders.
Order Completion Time
Orders of 10 eSIMs should complete fairly quickly. You should receive a 200OK and the orderReference in the response.
Ordering Multiple Bundles Using the Portal
1. Click on Buy Bundles in the Portal.
2. In Qty select a number which is 10 or less.
Ordering Multiple Bundles Using the API
1. API Call Sequence:
- Create an order: Use POST /orders endpoint.
- You will receive a unique orderReference in the response
- Complete all of the orders and collect the references
- Pass the references into the GET /esims/assignments endpoint using an Accept header of application/zip to retrieve ZIP files containing the QR codes and ICCIDs.
We have dedicated developer documentation about the POST /orders endpoint here..
2. Parameters for Bundle and New eSIMs:
When creating an order (POST /orders), you need to specify:
- The bundle name you want to order
- Quantity of eSIMs
- Set 'assign' parameter to true for auto-assignment
3. Potential Errors:
- Insufficient balance
- Too many requests (429 - API rate limiting)
- Badly formatted request (400)