Skip to content
Linra Omni Developer Docs

List orders across all product types (unified view)

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

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
page
integer
default: 1 >= 1
pageSize
integer
default: 20 >= 1 <= 100
productType
string
Allowed values: Topup Esim Scent
status

The one status vocabulary every product’s order maps into. Today only Processing, Failed, and PartiallyReturned are actually written — fulfillment-status sync into Completed/Cancelled/Returned is a tracked future improvement, not yet live.

string
Allowed values: Processing Completed Failed Cancelled PartiallyReturned Returned
from
string format: date-time
to
string format: date-time

Responses

Section titled “Responses”

200

Section titled “200”

A page of unified order summaries.

Media typeapplication/json
object
state
required
string
payload
required
details
object
payload
required
object
items
Array<object>
object
orderGlobalId
string
partnerId
string format: uuid
productType
string
Allowed values: Topup Esim Scent
productOrderId
string format: uuid
nullable
externalReference
string
amount
number format: decimal
currency
string
status

The one status vocabulary every product’s order maps into. Today only Processing, Failed, and PartiallyReturned are actually written — fulfillment-status sync into Completed/Cancelled/Returned is a tracked future improvement, not yet live.

string
Allowed values: Processing Completed Failed Cancelled PartiallyReturned Returned
failureCode
string
nullable
createdAt
string format: date-time
completedAt
string format: date-time
nullable
displayCurrency

Set only when the partner’s preferred display currency differs from SAR.

string
nullable
rate
number
nullable
amountDisplay
number
nullable
pagination
object
page
integer
pageSize
integer
totalCount
integer
totalPages
integer
Example
{
  "state": "SUCCESS",
  "payload": {
    "items": [
      {
        "productType": "Topup",
        "currency": "SAR",
        "status": "Processing"
      }
    ]
  }
}

429

Section titled “429”

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

Media typeapplication/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

Section titled “Headers”
Retry-After
integer

Seconds to wait before retrying.