List vendor orders

List the shipments assigned to you.

Orders

GET/api/v1/scent/orders

Returns a paged, cost-stripped list of your own fulfilment groups — the API’s term for the shipment/parcel assigned to you (groupId in the response). Never a sibling vendor’s shipment, Linra’s own Self-fulfilled one, 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). status is a repeatable match-any filter (?status=Shipped&status=Delivered) — a single occurrence still works; omit it entirely to include every status. 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.

Query parameters

pageinteger

1-based page number (default 1). A value below 1, or one that is not a whole number, returns 400 VALIDATION_INVALID_PAGE.

pageSizeinteger

Items per page, 1 to 100 (default 20). Any other value returns 400 VALIDATION_INVALID_PAGE_SIZE; it is never silently clamped.

statusarray of string (enum)

Repeatable match-any filter over fulfilment status (?status=Shipped&status=Delivered). Omit to include every status.

changedSincestring (date-time)

Only return rows whose parent order changed strictly after this UTC instant (delta sync). Read as UTC when it carries no offset; a date-only value means 00:00Z. An unparseable value, or a from/to pair with from after to, returns 400 VALIDATION_INVALID_DATE.

Response

itemsarray of object

pagination.pageinteger

pagination.pageSizeinteger

pagination.totalCountinteger

pagination.totalPagesinteger

Other responses

400A query parameter was rejected. Unknown parameter name: VALIDATION_UNKNOWN_QUERY_PARAMETER (details.allowedParameters). Value that does not parse (id, enum, number, boolean): VALIDATION_INVALID_QUERY_PARAMETER (enums add details.allowedValues). Unknown include token: VALIDATION_UNKNOWN_INCLUDE (details.allowedValues). pageSize outside 1–100: VALIDATION_INVALID_PAGE_SIZE. page below 1: VALIDATION_INVALID_PAGE. Unparseable date, or a from/to pair with from after to: VALIDATION_INVALID_DATE. details.errors names every offending parameter.

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.

404No API route matches this path (NOT_FOUND_ROUTE). A missing resource on a real route returns that service’s own NOT_FOUND_* code instead.

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 --request GET \
  --url https://api-omni-vendors.linra.net/api/v1/scent/orders \
  --header 'Authorization: Bearer $TOKEN'

const res = await fetch('https://api-omni-vendors.linra.net/api/v1/scent/orders', {
  headers: {
    Authorization: `Bearer ${token}`,
  },
});
const { payload } = await res.json();

var response = await httpClient.GetAsync("https://api-omni-vendors.linra.net/api/v1/scent/orders");

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

Response

{
  "state": "SUCCESS",
  "payload": {
    "items": [
      {
        "groupId": "5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b",
        "status": "Pending",
        "vendorOrderId": "string",
        "packedAt": "2026-08-22T09:14:03Z",
        "shippedAt": "2026-08-22T09:14:03Z",
        "deliveredAt": "2026-08-22T09:14:03Z",
        "shipTo": {
          "recipient": "string",
          "line1": "string",
          "line2": "string",
          "city": "string",
          "region": "string",
          "postalCode": "string",
          "country": "string",
          "phone": "string"
        },
        "tracking": {
          "ref": "string",
          "carrier": {},
          "carrierNameOther": "string"
        },
        "lines": [
          {
            "lineId": "5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b",
            "variantId": "5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b",
            "sku": "string",
            "quantity": 0
          }
        ]
      }
    ],
    "pagination": {
      "page": 0,
      "pageSize": 0,
      "totalCount": 0,
      "totalPages": 0
    }
  },
  "details": null
}