> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/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.