Skip to content
Linra Omni Vendor Docs

List the calling vendor's offers

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

Returns a paged list of the calling vendor’s own offers (any submission source), optionally filtered by status. Requires the Offers capability.

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
status
string
Allowed values: Draft PendingMatch PendingReview Approved Rejected Withdrawn Suspended

Responses

Section titled “Responses”

200

Section titled “200”

A page of offers.

Media typeapplication/json
object
state
required
string
payload
required
details
object
payload
required
object
items
Array<object>
object
id
string format: uuid
vendorId
string format: uuid
variantId
string format: uuid
nullable
status
string
Allowed values: Draft PendingMatch PendingReview Approved Rejected Withdrawn Suspended
source
string
Allowed values: Manual Import Api
vendorSku
string
nullable
vendorExternalId
string
nullable
cost

Always the NET (ex-VAT) figure.

number format: decimal
pendingCost

A cost change awaiting reviewer approval, if one is in flight. Null otherwise.

number format: decimal
nullable
costIsVatInclusive

Always false. Pair Cost 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 costEnteredVatInclusive for how you actually entered it.

boolean
costEnteredVatInclusive

Display-only — the vendor’s actual original entry-mode preference (how Cost was declared: exclusive/net or inclusive/gross). NEVER accepted on a write; use costIsVatInclusive (always false) for that.

boolean
inputVatAmount

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

number format: decimal
pendingInputVatAmount
number format: decimal
nullable
declaredStockQuantity
integer
nullable
declaredInStock
boolean
rawBrandName
string
nullable
rawProductName
string
nullable
rawConcentration
string
nullable
rawSizeMl
integer
nullable
rawDescription
string
nullable
syncPaused
boolean
autoPublishEligible
boolean
reviewedByUserId
string format: uuid
nullable
reviewedAt
string format: date-time
nullable
reviewReason
string
nullable
importBatchId
string format: uuid
nullable
supplyOptionId
string format: uuid
nullable
version

Optimistic-concurrency token (informational on this API — no vendor endpoint requires you to send it back).

integer
createdDate
string format: date-time
nullable
lastModifiedDate
string format: date-time
nullable
pagination
object
page
integer
pageSize
integer
totalCount
integer
totalPages
integer
Example
{
  "state": "SUCCESS",
  "payload": {
    "items": [
      {
        "status": "Draft",
        "source": "Manual"
      }
    ]
  }
}

403

Section titled “403”

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

Media typeapplication/json
object
state
required
string
payload
details
object
Examples
ExamplemissingCapability
{
  "state": "FORBIDDEN_CAPABILITY_NOT_GRANTED",
  "payload": null,
  "details": {
    "requiredCapability": "Orders"
  }
}

429

Section titled “429”

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

Media typeapplication/json
object
state
required
string
payload
details
object
Example
{
  "state": "NOT_FOUND_VENDOR_OFFER"
}

Headers

Section titled “Headers”
Retry-After
integer

Seconds to wait before retrying.