Get vendor offer by ID

Offers

GET/api/v1/scent/offers/{id}

Returns a single offer by ID, scoped to the calling vendor (any submission source). An offer belonging to another vendor is reported as 404 — indistinguishable from a nonexistent one. Requires the Offers capability.

Path parameters

idstring (uuid)Required

Response

idstring (uuid)

statusstring (enum)

Draft (saved, not submitted) → PendingMatch (no variantId, awaiting reviewer match) or PendingReview (a proposed match, awaiting approval) → Approved (live) → Withdrawn/Suspended; Rejected is reachable from Draft/PendingMatch/PendingReview. You never set Approved yourself. PendingRepricing: your agreement’s pricing model was switched by Linra while this offer was Approved or PendingReview — the offer’s linked supply is paused (not sellable) until you resubmit ONLY the new model’s price field (cost under Model 1, sale price under Model 2; stock updates are still accepted and never change this status) and it is re-reviewed, at which point it returns to PendingReview and then Approved as usual.

pricingModelobject

CostPlusMargin (“Model 1”): you declare cost, Linra adds a markup. PercentageOfSale (“Model 2”): you declare the final sale price; Linra + the reselling partner deduct a percentage of it.

vendorExternalIdstring

Opaque id reserved for API integrations; doubles as an idempotency key.

product.variantIdstring (uuid)

A vendor-proposed match to an existing, active Variant. Null for an unmatched free-form entry.

product.vendorSkustring

product.barcodestring

The product’s EAN/UPC barcode. Null only on an offer created before the barcode became required, until its next edit.

product.rawBrandNamestring

product.rawProductNamestring

product.rawConcentrationstring

product.rawSizeMlinteger

product.rawDescriptionstring

cost.amountnumber (decimal)

The live, stored NET cost Linra pays you (SAR).

cost.isVatInclusiveboolean

Always false — pair amount with this value (false) on a write to safely resubmit it unchanged. This is the one entry mode that can never re-interpret an already-net figure as a fresh gross one. See enteredVatInclusive for how you actually entered it.

cost.enteredVatInclusiveboolean

Display-only — your actual original entry-mode preference. NEVER accepted on a write; use isVatInclusive (always false) for that.

cost.inputVatnumber (decimal)

Your own input VAT on the current cost, back-derived when enteredVatInclusive is true.

cost.pendingobject

A cost change staged by you (or an internal edit) on an Approved offer, awaiting reviewer approval — the live cost above is untouched until applied.

price.amountnumber (decimal)

The live, stored NET sale price (SAR).

price.isVatInclusiveboolean

Always false — pair amount with this value (false) on a write to safely resubmit it unchanged. See enteredVatInclusive for how you actually entered it.

price.enteredVatInclusiveboolean

Display-only — your actual original entry-mode preference. NEVER accepted on a write.

price.vatnumber (decimal)

The VAT on the current sale price, back-derived when enteredVatInclusive is true.

price.pendingobject

A sale-price change staged by you on an Approved offer, awaiting reviewer approval — the live sale price above is untouched until applied.

stock.declaredQuantityinteger

Your declared quantity on hand, when you report a number rather than a bare yes/no.

stock.declaredInStockboolean

review.reviewedAtstring (date-time)

review.reasonstring

Other responses

401No bearer token (UNAUTHORIZED_MISSING_TOKEN), an invalid token (UNAUTHORIZED_INVALID_TOKEN) or an expired one (UNAUTHORIZED_TOKEN_EXPIRED — mint a new token). UPSTREAM_AUTH_FAILED is different: a dependent service refused the Gateway itself. That is a server-side fault — retry later and do NOT re-mint your token. See the Rate limits & errors guide.

403Your token doesn’t carry the capability this endpoint requires.

404Unknown offer id, or one belonging to another vendor.

429Too many requests. Retry after the Retry-After header (seconds).

502A dependent service returned an invalid response (BAD_GATEWAY). Retry with backoff.

503The service is temporarily unavailable (SERVICE_UNAVAILABLE). Retry with backoff.

504A dependent service did not respond in time (GATEWAY_TIMEOUT). Retry with backoff.

cURL

curl --request GET \
  --url https://api-omni-vendors.linra.net/api/v1/scent/offers/5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b \
  --header 'Authorization: Bearer $TOKEN'

JavaScript

const res = await fetch('https://api-omni-vendors.linra.net/api/v1/scent/offers/5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b', {
  headers: {
    Authorization: `Bearer ${token}`,
  },
});
const { payload } = await res.json();

C#

var response = await httpClient.GetAsync("https://api-omni-vendors.linra.net/api/v1/scent/offers/5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b");

var envelope = await response.Content.ReadFromJsonAsync<ApiResponse<VendorOfferResponse>>();

Response

{
  "state": "SUCCESS",
  "payload": {
    "id": "5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b",
    "status": "Draft",
    "pricingModel": {},
    "vendorExternalId": "string",
    "product": {
      "variantId": "5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b",
      "vendorSku": "string",
      "barcode": "string",
      "rawBrandName": "string",
      "rawProductName": "string",
      "rawConcentration": "string",
      "rawSizeMl": 0,
      "rawDescription": "string"
    },
    "cost": {
      "amount": 0,
      "isVatInclusive": true,
      "enteredVatInclusive": true,
      "inputVat": 0,
      "pending": {
        "amount": 0,
        "inputVat": 0
      }
    },
    "price": {
      "amount": 0,
      "isVatInclusive": true,
      "enteredVatInclusive": true,
      "vat": 0,
      "pending": {
        "amount": 0,
        "vat": 0
      }
    },
    "stock": {
      "declaredQuantity": 0,
      "declaredInStock": true
    },
    "review": {
      "reviewedAt": "2026-08-22T09:14:03Z",
      "reason": "string"
    }
  },
  "details": null
}