---
search:
  tags:
    - Orders
    - GET
seo:
  description: >-
    Lists orders visible to the token, newest first. Requires a Public REST API
    token carrying either the… Reference for the GET /orders endpoint in the
    Sibi API.
sidebar:
  label: List orders
  badge: GET
title: List orders
type: openapi-operation
---
Lists orders visible to the token, newest first. Requires a Public REST API token carrying either the `read:orders` or the `read:own:orders` scope. A token carrying `read:orders` sees the orders its user can see in Sibi: orders placed under the user’s primary organization, orders on that organization’s properties, and orders the user placed. A token carrying only `read:own:orders` sees the orders its user placed. Filter with `poNumber` to keep only orders whose `poNumber` equals the value exactly. Filter by property address with `line1`, `city`, `stateOrProvince`, and `postalCode` (all four required together; `line2` optional) — the address must match a property exactly, and the list narrows to orders on the matching properties. Page with `first` and `after`. A page may hold fewer than `first` items because rows are filtered after the search; only a `null` `next` ends the list, so keep paging until `next` is `null`.

`GET /orders`

**Responses**

- `200` — One page of orders.
- `400` — Bad request - Invalid query parameters
- `401` — Unauthorized - Missing or invalid authentication
- `403` — Forbidden - the token was minted for the other environment, is not a Public REST API token, or does not carry either scope this operation accepts
- `500` — Internal server error
- `503` — Service unavailable.

Response example, 200:

```json
{
  "next": "MjU",
  "items": [
    {
      "id": "SIBI-12345678",
      "poNumber": "PO-123456",
      "viewUrl": "https://web.sibipro.com/orders/SIBI-12345678",
      "createdAt": "2026-08-18T12:00:00Z",
      "propertyAddress": {
        "line1": "1630 W Guadalupe Rd",
        "line2": "Ste 101",
        "city": "Gilbert",
        "stateOrProvince": "AZ",
        "postalCode": "85233",
        "country": "USA"
      },
      "fulfillmentMethod": "DELIVERY",
      "requestedFulfillmentDate": "2026-08-20",
      "estimatedFulfillmentDate": "2026-08-20",
      "fulfillmentTimeStart": "string",
      "fulfillmentTimeEnd": "string",
      "actualFulfillmentDate": "string",
      "status": "Processed",
      "statusDetail": "string",
      "lineItems": [
        {
          "sku": "GDF510PSRSS",
          "name": "GE Dishwasher",
          "quantity": 1,
          "unitOfMeasure": "EA",
          "unitPriceCents": 54900,
          "totalPriceCents": 109800,
          "options": [
            {
              "key": "ppg-paint-color",
              "value": "PPG1105-3",
              "name": "Delicate White",
              "hex": "#F1EEE6"
            }
          ]
        }
      ],
      "fees": [
        {
          "name": "Delivery fee",
          "amountCents": 999
        }
      ],
      "exceptions": [
        {
          "createdAt": "2026-08-18T12:00:00Z",
          "sku": "string",
          "message": "string",
          "category": "string"
        }
      ],
      "deliveryContact": {
        "name": "string",
        "phone": "string",
        "email": "string"
      },
      "orderingUser": {
        "firstName": "John",
        "lastName": "Doe",
        "email": "john.doe@example.com"
      },
      "images": [
        {
          "url": "string"
        }
      ],
      "confirmationNumbers": [
        {
          "value": "string"
        }
      ],
      "cancellationRequest": {
        "status": "Pending",
        "reason": "string",
        "createdAt": "string",
        "updatedAt": "string"
      },
      "returnRequests": [
        {
          "createdAt": "string",
          "updatedAt": "string",
          "items": [
            {
              "sku": "GDF510PSRSS",
              "quantity": 0,
              "condition": "UNOPENED",
              "requestReason": "string",
              "status": "Pending",
              "denialReason": "string"
            }
          ]
        }
      ]
    }
  ]
}
```

Response example, 400:

```json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input parameters",
  "details": [
    {
      "field": "after",
      "error": "The `after` cursor is invalid."
    }
  ]
}
```

Response example, 401:

```json
{
  "code": "UNAUTHORIZED",
  "message": "Missing or invalid authentication token"
}
```

Response example, 403 · environmentMismatch:

```json
{
  "code": "TOKEN_ENVIRONMENT_MISMATCH",
  "message": "A test token was used against the production API. Test tokens only work against the Sibi test environment; use a production token here."
}
```

Response example, 403 · restTokenRequired:

```json
{
  "code": "REST_TOKEN_REQUIRED",
  "message": "This endpoint only accepts Public REST API tokens. Create one at https://developer.sibipro.com."
}
```

Response example, 403 · insufficientScope:

```json
{
  "code": "INSUFFICIENT_SCOPE",
  "message": "The presented token is missing the `read:orders` and `read:own:orders` scopes, of which this endpoint requires at least one. Create a token with the scopes you need at https://developer.sibipro.com."
}
```

Response example, 500:

```json
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred"
}
```

Response example, 503:

```json
{
  "code": "AUTH_UNAVAILABLE",
  "message": "Authentication service unavailable, retry shortly"
}
```