---
search:
  tags:
    - Orders
    - GET
seo:
  description: >-
    Returns orders for a shop, or for a whole seller across all of its shops.
    Reference for the GET /orders endpoint in the Bolder API v2.
sidebar:
  label: List orders
  badge: GET
title: List orders
type: openapi-operation
---
Returns orders for a shop, or for a whole seller across all of its shops.

`shop_id` and `seller_id` are both optional. If the token covers exactly
one shop, that shop is auto-resolved and results are scoped to it. If the
token covers multiple shops belonging to a single seller, omitting both
params returns orders across all of that seller's shops. A token covering
multiple sellers (or a god token) must pass `shop_id` or `seller_id`
explicitly — there is no "all sellers" search.

`GET /orders`

**cURL**

```bash
# List all orders for a shop
curl -s -H "Authorization: Bearer $BOLDER_TOKEN" \
  "https://api.onbolder.com/v2/orders?shop_id=1"

# List orders across all of a seller's shops
curl -s -H "Authorization: Bearer $BOLDER_TOKEN" \
  "https://api.onbolder.com/v2/orders?seller_id=1"

# Filter by status
curl -s -H "Authorization: Bearer $BOLDER_TOKEN" \
  "https://api.onbolder.com/v2/orders?shop_id=1&status=open"
```

**Responses**

- `200` — Paginated list of orders
- `403` — Access denied to the given shop or seller
- `422` — \`shop\_id\` or \`seller\_id\` required — the token covers more than one shop and more than one seller (or is a god token), so neither can be auto-resolved.

Response example, 200:

```json
{
  "_class": [
    "results",
    "orders"
  ],
  "total_items": 1,
  "per_page": 20,
  "page": 1,
  "_links": {
    "self": {
      "href": "https://api.onbolder.com/v2/orders?shop_id=1"
    },
    "shops:show": {
      "href": "https://api.onbolder.com/v2/shops/1"
    }
  },
  "_embedded": {
    "orders": [
      {
        "id": 5001,
        "shop_id": 1,
        "code": "ORD-5001",
        "status": "pending",
        "fulfillment_status": "none",
        "currency_code": "USD",
        "total": 8499,
        "total_paid": 8499,
        "created_on": "2024-06-15T09:45:00Z",
        "_embedded": {
          "contact": {
            "id": 42,
            "name": "Jane Doe",
            "email": "customer@example.com",
            "phone_number": "+15551234567"
          }
        },
        "_links": {
          "self": {
            "href": "https://api.onbolder.com/v2/orders/ORD-5001"
          },
          "orders:update": {
            "href": "https://api.onbolder.com/v2/orders/ORD-5001",
            "method": "put"
          }
        }
      }
    ]
  }
}
```