mobileOrders

Requires a customer (portal or buyer app) session.

Returns the buyer's paginated order list. status is a plain Int: 0=All, 1=Active (not delivered/cancelled), 2=Cancelled. Optionally narrowed further by a placed-at date range and a search term (matches order number or an item's product name).

Errors: a failed call returns a GraphQL errors entry, not a field on the result, and data may be null or partial. Read the entry's extensions.code and message; every shape and code is in the Error reference.

Example:

GraphQL

query MobileOrders {
  mobileOrders {
    hasNextPage
    nextCursor
    totalCount
    nodes {
      id
      orderNumber
      paymentNumber
      salesRepName
      status
      addressId
    }
  }
}

cURL

curl -X POST "https://<api-host>/graphql" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data @- <<'EOF'
{
  "query": "query MobileOrders {\n  mobileOrders {\n    hasNextPage\n    nextCursor\n    totalCount\n    nodes {\n      id\n      orderNumber\n      paymentNumber\n      salesRepName\n      status\n      addressId\n    }\n  }\n}"
}
EOF

Response:

{
  "data": {
    "mobileOrders": {
      "hasNextPage": true,
      "nextCursor": "string",
      "totalCount": 0,
      "nodes": [
        {
          "id": "id",
          "orderNumber": "string",
          "paymentNumber": "string",
          "salesRepName": "string",
          "status": "AWAITING_PAYMENT",
          "addressId": "id"
        }
      ]
    }
  }
}

mobileOrders(
  cursor: String
  dateFrom: DateTime
  dateTo: DateTime
  limit: Int = 20
  search: String
  status: Int = 0
): MobileOrderConnection!

Arguments

mobileOrders.cursor ● String scalar

Cursor from the previous page. Omit for the first page.

mobileOrders.dateFrom ● DateTime scalar

Only records on or after this date.

mobileOrders.dateTo ● DateTime scalar

Only records on or before this date.

mobileOrders.limit ● Int scalar

Maximum number of records to return.

mobileOrders.search ● String scalar

Text to search for.

mobileOrders.status ● Int scalar

Only orders with this status code. Defaults to 0, which means all.

Type

MobileOrderConnection object

Cursor-paginated list of buyer orders, read from Postgres (SalesOrder) scoped to the buyer's organization + partner. Redis is a read cache only — never the list's source of truth.