Skip to content
Linra Omni Vendor Docs

List the calling vendor's fulfilment groups

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

Returns a paged, cost-stripped list of fulfilment groups assigned to the calling vendor — never a sibling vendor’s group, the Self (Linra-fulfilled) group, or an order’s OTHER vendors’ lines. No partner identity, order totals, commission, or any money field is ever present (see the schema’s own field-by-field remarks). Set changedSince for delta sync: only groups whose PARENT ORDER changed strictly after that instant are returned, ordered by change time ascending. A sibling vendor’s own group changing on the SAME order also bumps this timestamp — treat a repeat of your own unchanged group as a safe, over-inclusive signal, never under-inclusive, and reconcile idempotently. Requires the Orders 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: Pending Packed Shipped Delivered Cancelled Returned PendingSourcing
changedSince
string format: date-time

Only return rows whose parent order changed strictly after this UTC instant (delta sync).

Responses

Section titled “Responses”

200

Section titled “200”

A page of fulfilment groups.

Media typeapplication/json
object
state
required
string
payload
required
details
object
payload
required
object
items
Array<object>

Deliberately EXCLUDES the reselling partner’s identity, any customer/external reference, and every money/tax field (order total, commission, VAT, currency, discounts, tax-registration numbers) and the internal saga correlation id — none of it is the vendor’s business. You are paid via your own commercial terms with Linra, tracked entirely on the offer/cost-push side, never derived from what a partner paid.

object
groupId
string format: uuid
orderGlobalId

Linra’s own canonical order id — stable across both sides for support/correlation. Never the partner’s own external reference.

string
status
string
Allowed values: Pending Packed Shipped Delivered Cancelled Returned PendingSourcing
vendorOrderId

Your own order/reference id at your end, if previously pushed.

string
nullable
trackingRef
string
nullable
packedAt
string format: date-time
nullable
shippedAt
string format: date-time
nullable
deliveredAt
string format: date-time
nullable
shipRecipient
string
shipLine1
string
shipLine2
string
nullable
shipCity
string
shipRegion
string
nullable
shipPostalCode
string
nullable
shipCountry
string
shipPhone
string
lines
Array<object>

Trimmed to exactly what’s needed to pack the shipment. No money field of any kind is present.

object
lineId
string format: uuid
variantId
string format: uuid
sku

The catalog SKU for this variant, resolved regardless of the variant’s current active state.

string
quantity
integer
pagination
object
page
integer
pageSize
integer
totalCount
integer
totalPages
integer
Example
{
  "state": "SUCCESS",
  "payload": {
    "items": [
      {
        "status": "Pending"
      }
    ]
  }
}

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.