List the caller's eSIM orders

GET

/api/v1/orders/esim

const url = 'https://api-omni.linra.net/api/v1/orders/esim?page=1&pageSize=20';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api-omni.linra.net/api/v1/orders/esim?page=1&pageSize=20' \
  --header 'Authorization: Bearer <token>'

Authorizations

partnerBearer

Parameters

Query Parameters

page

integer

default: 1 >= 1

pageSize

integer

default: 20 >= 1 <= 100

Responses

200

A page of eSIM orders.

application/json

object

state

required

string

payload

required

details

object

payload

required

object

items

Array<object>

object

orderId

string format: uuid

orderGlobalId

string

partnerId

string format: uuid

partnerGlobalId

string

geoScopeGlobalId

string

externalReference

string

status

string

statusDetail

Product-specific status detail carried on Topup/eSIM order responses.

object

productType

string

statusCode

string

description

string

nullable

productSku

string

email

string

dataAllowance

number format: decimal

validityDays

integer

amount

number format: decimal

currency

string

submittedAt

string format: date-time

completedAt

string format: date-time

nullable

esimIccid

Populated once provisioning succeeds.

string

nullable

esimQrCode

Populated once provisioning succeeds.

string

nullable

esimActivationCode

Populated once provisioning succeeds.

string

nullable

esimPlanDetails

Populated once provisioning succeeds.

string

nullable

errorMessage

string

nullable

displayCurrency

string

nullable

rate

number

nullable

amountDisplay

number

nullable

pagination

object

page

integer

pageSize

integer

totalCount

integer

totalPages

integer

Example

{
  "state": "SUCCESS",
  "payload": {
    "items": [
      {
        "statusDetail": {
          "productType": "Topup",
          "statusCode": "TOPUP_SUCCESS"
        },
        "currency": "SAR"
      }
    ]
  }
}

429

Too many requests — see the Rate limits guide. Retry after the Retry-After header (seconds).

application/json

The envelope every /api/v1 ERROR response uses. state carries the machine-readable error code (see the Errors guide).

object

state

required

string

payload

required

Always null on an error response.

object

details

object

Example

{
  "state": "NOT_FOUND_ORDER",
  "payload": null
}

Headers

Retry-After

integer

Seconds to wait before retrying.