---
search:
  tags:
    - Products
    - GET
seo:
  description: >-
    Returns products scoped to the authenticated account. Reference for the GET
    /products endpoint in the Bolder API v2.
sidebar:
  label: List products
  badge: GET
title: List products
type: openapi-operation
---
Returns products scoped to the authenticated account.

**Scope behaviour:**
- Tokens with `products.read` (or `products.write`) scoped to a seller/account:
  automatically scoped to the account's own sellers — no extra params needed.
- Tokens without an account/seller scope: `shop_subdomains` is **required**
  (prevents enumeration).

`GET /products`

**cURL**

```bash
# List all visible products (account-scoped token)
curl -s -H "Authorization: Bearer $BOLDER_TOKEN" \
  "https://api.onbolder.com/v2/products"

# Search with filters
curl -s -H "Authorization: Bearer $BOLDER_TOKEN" \
  "https://api.onbolder.com/v2/products?q=shirt&status=visible&per_page=50"
```

**Responses**

- `200` — Paginated list of products
- `401` — Invalid or missing token
- `403` — Access denied
- `422` — Missing required parameter (e.g. \`shop\_subdomains\` for tokens without an account/seller scope)

Response example, 200:

```json
{
  "_class": [
    "results",
    "products"
  ],
  "total_items": 2,
  "per_page": 20,
  "page": 1,
  "_links": {
    "self": {
      "href": "https://api.onbolder.com/v2/products"
    },
    "shops:show": {
      "href": "https://api.onbolder.com/v2/shops/1"
    }
  },
  "_embedded": {
    "items": [
      {
        "id": 101,
        "name": "Summer Dress",
        "slug": "summer-dress",
        "status": "visible",
        "price": 49.99,
        "regular_price": 69.99,
        "currency": "USD",
        "created_on": "2024-03-15T10:00:00Z",
        "_links": {
          "self": {
            "href": "https://api.onbolder.com/v2/products/101"
          },
          "products:update": {
            "href": "https://api.onbolder.com/v2/products/101",
            "method": "put"
          },
          "products:delete": {
            "href": "https://api.onbolder.com/v2/products/101",
            "method": "delete"
          }
        }
      },
      {
        "id": 102,
        "name": "Linen Shirt",
        "slug": "linen-shirt",
        "status": "visible",
        "price": 35,
        "regular_price": 35,
        "currency": "USD",
        "created_on": "2024-02-10T08:30:00Z",
        "_links": {
          "self": {
            "href": "https://api.onbolder.com/v2/products/102"
          }
        }
      }
    ]
  }
}
```