Skip to content
Linra Omni Developer Docs

Get a scent order by its own ID

GET
/api/v1/orders/scent/{orderId}
curl --request GET \
  --url https://api-omni.linra.net/api/v1/orders/scent/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
orderId
required
string format: uuid

The Scent order’s own GUID — the SAME id you already hold from order creation/tracking.

Responses

Section titled “Responses”

200

Section titled “200”

The scent order (internal cost/wholesale fields are never included here).

Media typeapplication/json
object
state
required
string
payload
required
details
object
payload
required
object
id
string format: uuid
orderGlobalId
string
sagaId
string
partnerId
string format: uuid
externalReference
string
customerRef
string
nullable
totalAmount
number format: decimal
totalCommission
number format: decimal
currency
string
status
string
lines
Array<object>

Deliberately omits internal cost/wholesale fields.

object
id
string format: uuid
variantId
string format: uuid
quantity
integer
returnedQuantity
integer
unitAmount
number format: decimal
lineTotal
number format: decimal
partnerCommission
number format: decimal
nullable
pricingMode
string
source
string
nullable
taxClassification
string
vatRateApplied
number format: decimal
lineGoodsVatAmount
number format: decimal
lineCommissionVatAmount
number format: decimal
nullable
unitAmountDisplay
number
nullable
lineTotalDisplay
number
nullable
partnerCommissionDisplay
number
nullable
fulfillmentGroups
Array<object>
object
id
string format: uuid
status
string
deliveredAt
string format: date-time
nullable
deliveryRollup
object
totalGroups
integer
deliveredGroups
integer
totalGoodsVatAmount
number format: decimal
totalCommissionVatAmount
number format: decimal
totalAmountWithVat
number
nullable
totalCommissionWithVat
number
nullable
taxPoint
string format: date-time
nullable
platformTaxRegistrationNumber
string
nullable
partnerTaxRegistrationNumber
string
nullable
partnerIsVatRegistered
boolean
displayCurrency
string
nullable
rate
number
nullable
totalAmountDisplay
number
nullable
Example
{
  "state": "SUCCESS",
  "payload": {
    "currency": "SAR"
  }
}

404

Section titled “404”

Unknown or cross-tenant order.

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
Examples
ExamplenotFound
{
  "state": "NOT_FOUND_SCENT_ORDER",
  "payload": null,
  "details": {}
}

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.