API v2.4 / Orders / List orders
GET /orders
Get details on all previous orders, including total cost and contents. Response data is paginated.
Authorizations
Parameters
Query Parameters
Set to true to include eSIM data (ICCID, Matching ID and SMDP Address) in the response, and an ICCIDs array.
Example
true
Page number to return.
Example
1
Number of results to return per page.
Example
10
Specifies the date range for filtering orders. This parameter has a 'lte:' prefix to specify the end date. For example, to query orders from March 1, 2024, to March 31, 2024, use the following format: `createdAt=gte:2024-03-01T00:00:00.000Z&createdAt=lte:2024-03-31T23:59:59.999Z`.
Example
<dateTime>
Responses
200
OK
object
Order type [ transaction ]
object
object
ICCID of eSIM new bundle was assigned to
SMDP+ ID (used in eSIM activation)
SMDP+ Address (used in eSIM activation)
Item type [ bundle ]
Name of the bundle
ICCID of eSIM new bundle was assigned to
Quantity of items
Cost of a bundle multiplied by its quantity
Price per each item
Allow a new eSIM to be provided if the bundle is not compatible with the eSIM profile
Total price
Currency of the transaction
Status of the order
Status message
Order reference
Data and time of order creation
Indicates if bundle was assigned to eSIM
Source IP of the order
{ "order": [ { "type": "bundle", "item": "esim_data_plan_2", "quantity": 1, "subTotal": 9.99, "pricePerUnit": 9.99, "AllowReassign": false, "esims": [ { "iccid": "8900000000000000001", "matchingId": "MATCH-001", "smdpAddress": "http://smdp.example.com" } ], "iccids": [ "8900000000000000001" ] } ], "total": 9.99, "currency": "USD", "status": "completed", "statusMessage": "Order completed: 1 eSIM assigned", "orderReference": "order-ref-002", "createdDate": "2023-06-14T15:45:00Z", "assigned": true, "sourceIP": "244.178.44.111"}
400
Bad Request - returned when request format is not accepted
object
Status of api functions which do not return data
403
Unauthorised - returned when the api token is invalid; the user does not have any available Bundles left or the ICCID is not accessible by the user
object
Status of api functions which do not return data
429
Too Many Requests
object
Status of api functions which do not return data
500
Server Error
object
Status of api functions which do not return data
503
Processing - Please come back later or use the Retry-After (seconds) header
object
Status of api functions which do not return data