> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/developer/api-reference/rest/b2b/storefront/orders/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# Orders

The Orders Storefront REST and GraphQL APIs allow you to retrieve order details from Company accounts. By authenticating requests as a Company user, you can retrieve information on the orders visible in their Buyer Portal.

In order to return order information, you must generate a storefront authToken for a buyer with the following [Company user permissions](/developer/api-reference/rest/b2b/management/company/company-roles-and-permissions):

* **Get orders**
* **Get order detail**

The storefront experience of placing an order, for both B2B and B2C customers, relies on the BigCommerce checkout or use of the standard BigCommerce APIs. As a result, the B2B Orders API does not include endpoints for creating new orders or adding existing orders. Use the [BigCommerce Orders V2 API](/developer/api-reference/rest/admin/management/orders) to accomplish these tasks.

When specifying an order as a parameter of an endpoint, provide the **BigCommerce order ID** as the unique identifier. The **B2B Edition Order ID**, presented as the `id` value of certain B2B Orders API responses, is not a supported identifier for the `bcOrderId` field.

## Legacy Extra Fields

The [Get All Orders](#get-all-orders) and [Get Order Details](#get-order-details) endpoints include the following legacy Company extra fields used by older stores:

* `extraInt1`
* `extraInt2`
* `extraInt3`
* `extraInt4`
* `extraInt5`
* `extraStr1`
* `extraStr2`
* `extraStr3`
* `extraStr4`
* `extraStr5`
* `extraText`

These fields return `null` values in newer stores. We recommend using the [Get Company Extra Fields](/developer/api-reference/rest/b2b/storefront/company/companies/get-companies-extra-fields-storefront) endpoint to retrieve Company extra field information.

> Build amazing commerce solutions powered by the BigCommerce platform


## API Docs

- Orders [List Orders](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/storefront/orders/get-orders.md)
- Orders [Create Order](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/storefront/orders/post-orders.md)
- Orders [List Order Images](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/storefront/orders/get-orders-images.md)
- Orders [List Order Products](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/storefront/orders/get-orders-order-id-products.md)
- Orders [Get Order Details](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/storefront/orders/get-orders-order-id-details.md)
- Orders [List Ordered Products](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/storefront/orders/get-ordered-products.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/storefront/orders/openapi.json)
- [OpenAPI YAML](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/storefront/orders/openapi.yaml)