For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dev Portal
DocsAPI ReferenceLearnCommunityChangelog
DocsAPI ReferenceLearnCommunityChangelog
    • About Our APIs
  • REST
    • Overview
      • Overview
      • Storefront
          • Authentication
          • Catalog
          • Company
          • Orders
            • GETList Orders
            • POSTCreate Order
            • GETList Order Images
            • GETList Order Products
            • GETGet Order Details
            • GETList Ordered Products
          • Request for Quote
          • Sales Rep
          • Shopping List
          • Store Settings
      • Management
  • GraphQL
    • Overview
  • MCP
    • Overview
Dev Portal
LogoLogo
RESTB2BStorefrontOrders

List Ordered Products

GET
https://api-b2b.bigcommerce.com/api/v2/ordered-products
GET
/api/v2/ordered-products
$curl -G https://api-b2b.bigcommerce.com/api/v2/ordered-products \
>     -H "Authorization: Bearer <token>" \
>     -d offset=10 \
>     -d limit=20 \
>     --data-urlencode beginDateAt=01/01/2025 \
>     --data-urlencode endDateAt=01/01/2025 \
>     -d minOrderedTimes=5 \
>     -d maxOrderedTimes=10 \
>     -d productID=123 \
>     --data-urlencode "q=Awaiting Payment"
200Retrieved
1{
2  "code": 200,
3  "data": {
4    "paginator": {
5      "totalCount": 1,
6      "offset": 0,
7      "limit": 10
8    },
9    "list": [
10      {
11        "orderProductId": "12345",
12        "productName": "Sansevieria",
13        "sku": "SAN-PL",
14        "productId": "321",
15        "variantId": "74669",
16        "lastOrdered": "1744894371",
17        "orderedTimes": "1",
18        "lastOrderedItems": "5",
19        "productBrandName": "Rustic Roots",
20        "optionList": [
21          {
22            "id": 1595,
23            "option_id": 32,
24            "order_product_id": 1461,
25            "product_option_id": 3773,
26            "display_name": "Size",
27            "display_name_customer": "Size",
28            "display_name_merchant": "Size",
29            "display_value": "Small",
30            "display_value_customer": "Small",
31            "display_value_merchant": "Small",
32            "value": "95",
33            "type": null,
34            "name": "Color1736973439-63261",
35            "display_style": "Rectangle"
36          }
37        ],
38        "optionSelections": [
39          {
40            "optionId": 3773,
41            "optionValue": "18836",
42            "type": "Multiple choice"
43          }
44        ],
45        "ordersInfo": [
46          {
47            "order_id": 23318773,
48            "quantity": 5,
49            "ordered_at": 1744894371,
50            "bc_order_id": 123
51          }
52        ],
53        "imageUrl": "https://mybcstore.com/images/products/12345/main.jpg"
54      }
55    ]
56  },
57  "message": "SUCCESS"
58}
Retrieves information related to products that a Company user has purchased. The information returned by this endpoint is different from the detailed product information returned by [Get Order Details](#get-order-details). However, it does include unique information like how many times a product was ordered and when it was last ordered. The response includes all products purchased by the Company user, but you can filter for a subset of products by using parameters. Common use cases include: * Retrieving products purchased within a date range by using `beginDateAt` and `endDateAt` * Retrieving products ordered a specific number of times by using `minOrderedTimes` and `maxOrderedTimes` * Retrieving information on similarly-named products by entering a partial product name as a `q` value * Retrieving information on a specific product by using `productID` Equivalent Storefront GraphQL API Query: `orderedProducts`. For more information, see the [GraphQL Playground](https://api-b2b.bigcommerce.com/graphql/playground).
Was this page helpful?
Previous

Get Order Details

Next

Quotes

Built with

Retrieves information related to products that a Company user has purchased. The information returned by this endpoint is different from the detailed product information returned by Get Order Details. However, it does include unique information like how many times a product was ordered and when it was last ordered.

The response includes all products purchased by the Company user, but you can filter for a subset of products by using parameters. Common use cases include:

  • Retrieving products purchased within a date range by using beginDateAt and endDateAt
  • Retrieving products ordered a specific number of times by using minOrderedTimes and maxOrderedTimes
  • Retrieving information on similarly-named products by entering a partial product name as a q value
  • Retrieving information on a specific product by using productID

Equivalent Storefront GraphQL API Query: orderedProducts. For more information, see the GraphQL Playground.

Authentication

AuthorizationBearer

Authentication header

HeaderArgumentDescription
AuthorizationBearer {{B2B_JWT_TOKEN}}You can obtain this token using the steps described in the REST Storefront API section[…]

Query parameters

offsetintegerOptionalDefaults to 0
The number of results to skip before returning the first result. If left blank, this defaults to 0.
limitintegerOptionalDefaults to 10
Determines the number of records to return per page. If left blank, this defaults to 10.
beginDateAtdatetimeOptional

Enter a date in %m/%d/%Y format to retrieve all orders placed after that time. If the parameter is not included in the request, the resposne includes orders placed 30 days before the current date.

endDateAtdatetimeOptional

Enter a date in %m/%d/%Y format to retrieve all orders placed before that time. If the parameter is not included in the request, the current date is used.

minOrderedTimesdoubleOptional
Enter a number to return products that have been ordered at least that many times by the Company user.
maxOrderedTimesdoubleOptional
Enter a number to return products that have been ordered at least that many times by the Company user.
productIDdoubleOptional
The unique identifier for the product.
qstringOptional

Enter order information to return partial and exact matches. Accepted information fields include order ID, order status name, Purchase Order (PO) number, and total order value including tax.

Response

OK
codeintegerDefaults to 200
dataobject