Skip to content

Get all orders

GET
/orders

Get details on all previous orders, including total cost and contents. Response data is paginated.

Authorizations

Parameters

Query Parameters

includeIccids
boolean

Set to true to include eSIM data (ICCID, Matching ID and SMDP Address) in the response, and an ICCIDs array.

Note: From v2.3.0 onwards, this data will be included by default.

page
integer
default: 1
1

Page number to return.

limit
integer
default: 10 <= 10000
10

Number of results to return per page.

createdAt
string format: date-time
lte:2024-03-31T23:59:59.999Z

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.

Responses

200

Success message

Array<object>
object
order

Items within the order

Array<object>
object
type

Item type. Supported: bundle,autoTopup, apiTopup, `topup“

string
item

Item name. This is the Bundle name when type = "bundle"

string
quantity

Quantity of item

integer
subTotal

Item Subtotal

integer
pricePerUnit

Price per Item

integer
invoiceLink

Topup Invoice Link

string
total

Order total

integer
currency

Order currency

string
status

Status of the order

string
statusMessage

Order status message

string
orderReference

Order Reference

string
createDate

Date/Time of order creation

Format as defined in RFC 3339, section 5.6. Timezone is UTC (ends with ‘Z’). Example: 2006-01-02T15:04:05Z

string

400

Bad Request - returned when request format is not accepted

object
message

Status of api functions which do not return data

string

403

Unauthorised - returned when the api token is invalid; the user does not have any available Bundles left or the eSIM is not accessible by the user

object
message

Status of api functions which do not return data

string

500

Server Error

object
message

Status of api functions which do not return data

string