Skip to content
Linra Omni Developer Docs
Search
Ctrl
K
Cancel
Select theme
Dark
Light
Auto
Start here
Overview
Getting started
Guides
Authentication & tokens
Environments
Idempotency
Cart preview & price locks
Webhooks & HMAC verification
Catalog delta sync
Discount codes
Product marketing (badges & compare-at)
Rate limits
Errors
Credentials
API Reference
Overview
Authentication
Overview
Exchange a client ID and secret for an access token
Orders
Overview
List orders across all product types (unified view)
Get one order by its global ID (unified view, any product type)
List the caller's top-up orders
Create a mobile top-up order
Get a top-up order by its own ID
Get a top-up order by your own externalReference
List the caller's eSIM orders
Create an eSIM order
Get an eSIM order by its own ID
Get an eSIM order by your own externalReference
List the caller's scent orders
Create a scent order from the caller's own open cart
Get a scent order by its own ID
Webhooks
Overview
List your webhook subscriptions
Create a webhook subscription
Get a webhook subscription by ID
Update a webhook subscription's URL and/or subscribed event types
Activate or deactivate a webhook subscription
Rotate a webhook subscription's signing secret
Send a real, signed test delivery for one event type
List recent delivery attempts for a subscription
Wallet
Overview
Get your own wallet balance
List your own wallet ledger transactions
Billing
Overview
List your persisted billing statements, or compute an on-demand provisional report
Get one persisted billing statement by ID
Catalog
Overview
List scents
Get a scent by ID
Get a single-unit partner price quote across a scent's active variants
List brands
Get a brand by ID
List variants
Get a variant by ID
Get a variant's current availability
Cart
Overview
Get your own cart
Add an item to your cart (or merge quantity into an existing line)
Remove every line from your cart
Set a line's quantity (0 removes the line)
Remove one line (idempotent — removing an absent line is not an error)
Price the current cart, optionally locking the prices
Register to be notified when a variant becomes available again
Cancel a back-in-stock notification registration
List your back-in-stock notify registrations
Check a discount code against the current cart
Returns
Overview
Request a return on a delivered fulfillment group
List every return request submitted against one order
Discount Codes
Overview
List your discount codes
Create a discount code
Get one of your discount codes by ID
Delete a discount code that has never been redeemed
Update one of your discount codes
Reference
Changelog
Select theme
Dark
Light
Auto
Overview
Webhooks
Section titled “Webhooks”
Manage webhook subscriptions and inspect delivery history.
Operations
Section titled “Operations”
GET
/api/v1/webhooks
POST
/api/v1/webhooks
GET
/api/v1/webhooks/{id}
PUT
/api/v1/webhooks/{id}
PATCH
/api/v1/webhooks/{id}/active
POST
/api/v1/webhooks/{id}/rotate-secret
POST
/api/v1/webhooks/{id}/test-fire
GET
/api/v1/webhooks/{id}/deliveries