Skip to content
Linra Omni Developer Docs

Overview

Linra Omni Partner API v1

Section titled “Linra Omni Partner API v1”

The Linra Omni partner-facing API — reachable through the Gateway’s /api/v1 facade (src/ApiGateway/Linra.Omni.Gateway/appsettings.json, ReverseProxy:Routes). Every path in this document is a real, currently-deployed partner-reachable route; this document is GENERATED — see tools/openapi-spec-gen/ and do not hand-edit openapi.json.

This is a curated facade over several internal services (Identity, OrderGateway, Wallet, Products.Scent) — it deliberately excludes every admin/internal endpoint, every [BffOnly]-gated surface, and every internal cost/margin/stocking-policy field.

Full developer guides (authentication, webhooks, errors, rate limits, ...)

Operations

Section titled “Operations”
POST
/api/v1/auth/token
GET
/api/v1/orders
GET
/api/v1/orders/{orderGlobalId}
GET
/api/v1/orders/topup
POST
/api/v1/orders/topup
GET
/api/v1/orders/topup/{orderId}
GET
/api/v1/orders/topup/reference/{externalReference}
GET
/api/v1/orders/esim
POST
/api/v1/orders/esim
GET
/api/v1/orders/esim/{orderId}
GET
/api/v1/orders/esim/reference/{externalReference}
GET
/api/v1/orders/scent
POST
/api/v1/orders/scent
GET
/api/v1/orders/scent/{orderId}
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
GET
/api/v1/wallet/balance
GET
/api/v1/wallet/transactions
GET
/api/v1/statements
GET
/api/v1/statements/{id}
GET
/api/v1/scent/catalog/scents
GET
/api/v1/scent/catalog/scents/{id}
GET
/api/v1/scent/catalog/scents/{id}/quote
GET
/api/v1/scent/catalog/brands
GET
/api/v1/scent/catalog/brands/{id}
GET
/api/v1/scent/catalog/variants
GET
/api/v1/scent/catalog/variants/{id}
GET
/api/v1/scent/catalog/variants/{id}/availability
GET
/api/v1/scent/cart
POST
/api/v1/scent/cart/items
DELETE
/api/v1/scent/cart/items
PUT
/api/v1/scent/cart/items/{variantId}
DELETE
/api/v1/scent/cart/items/{variantId}
GET
/api/v1/scent/cart/checkout-preview
POST
/api/v1/scent/cart/notify/{variantId}
DELETE
/api/v1/scent/cart/notify/{variantId}
GET
/api/v1/scent/cart/notify
POST
/api/v1/scent/cart/discount-code/validate
POST
/api/v1/scent/orders/{id}/return-request
GET
/api/v1/scent/orders/{id}/return-requests
GET
/api/v1/scent/discount-codes
POST
/api/v1/scent/discount-codes
GET
/api/v1/scent/discount-codes/{id}
DELETE
/api/v1/scent/discount-codes/{id}
PATCH
/api/v1/scent/discount-codes/{id}

Authentication

Section titled “Authentication”

partnerBearer

Section titled “partnerBearer”

A partner access token from POST /api/v1/auth/token (audience partner-api, 5-minute lifetime).

Security scheme type: http

Bearer format: JWT