> 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/admin/management/orders/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# Orders V2

Manage order coupons, messages, products, shipping addresses, statuses, taxes, shipments, and shipping address quotes.

## Order

The Order object contains a record of the purchase agreement between a shopper and a merchant. To learn more about creating orders, see [Orders API Guide](/developer/docs/admin/checkout-and-cart/orders).

### Currency Fields

The **default** currency refers to the transactional currency which is the currency the shopper pays in.

The **display** currency refers to the presentational currency used to present prices to the shopper on the storefront.

* `currency_id` - the display currency ID. Depending on the currency selected, the value may be different from the transactional currency.
* `currency_code` - the currency code of the display currency used to present prices to the shopper on the storefront. Depending on the currency selected, the value may be different from the transactional currency.
* `currency_exchange_rate` - the exchange rate between the store’s default currency and the display currency. For orders created using the V2 endpoints, this value is always 1 (only in the storefront this value can be different to 1).
* `default_currency_id` - the transactional currency ID.
* `default_currency_code` - the currency code of the transactional currency the shopper pays in.

The following additional fields are returned on orders when Multi-Currency is enabled on the store:

* `store_default_currency_code` - the currency code of the store’s default currency.
* `store_default_to_transactional_exchange_rate` - the exchange rate between the store’s default currency and the transactional currency used in the order.

**Example:**

```json
{
  ...
  "currency_id": 4,
  "currency_code": "EUR",
  "currency_exchange_rate": 1,
  "default_currency_id": 4,
  "default_currency_code": "EUR",
  "store_default_currency_code": "USD",
  "store_default_to_transactional_exchange_rate": "100.0000000000"
  ...
}
```

> Build amazing commerce solutions powered by the BigCommerce platform


## API Docs

- Admin Management: Orders [Get Order](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/get-order.md)
- Admin Management: Orders [Update Order](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/update-order.md)
- Admin Management: Orders [Archive Order](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/delete-order.md)
- Admin Management: Orders [Get Count of Orders](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/get-orders-count.md)
- Admin Management: Orders [List Orders](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/get-orders.md)
- Admin Management: Orders [Create Order](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/create-order.md)
- Admin Management: Orders [Delete All Orders](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/delete-orders.md)
- Admin Management: Orders > Order Consignments [List Consignments](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-consignments/get-order-consignments.md)
- Admin Management: Orders > Order Consignments [List Consignment Shipping Quotes](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-consignments/get-order-consignment-shipping-quotes.md)
- Admin Management: Orders > Order Coupons [List Order Coupons](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-coupons/get-order-coupons.md)
- Admin Management: Orders > Order Fees [List Fees](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-fees/get-order-fees.md)
- Admin Management: Orders > Order Messages [List Order Messages](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-messages/get-order-messages.md)
- Admin Management: Orders > Order Products [List Order Products](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-products/get-order-products.md)
- Admin Management: Orders > Order Products [Get Order Product](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-products/get-order-product.md)
- Admin Management: Orders > Order Shipments [List Order Shipments](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-shipments/get-order-shipments.md)
- Admin Management: Orders > Order Shipments [Create Order Shipment](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-shipments/create-order-shipments.md)
- Admin Management: Orders > Order Shipments [Delete Order Shipments](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-shipments/delete-order-shipments.md)
- Admin Management: Orders > Order Shipments [Get Count of Order Shipments](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-shipments/get-order-shipments-count.md)
- Admin Management: Orders > Order Shipments [Get Shipment](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-shipments/get-order-shipment.md)
- Admin Management: Orders > Order Shipments [Update Shipment](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-shipments/update-order-shipment.md)
- Admin Management: Orders > Order Shipments [Delete Order Shipment](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-shipments/delete-order-shipment.md)
- Admin Management: Orders > Order Shipping Addresses [List Order Shipping Addresses](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-shipping-addresses/get-order-shipping-addresses.md)
- Admin Management: Orders > Order Shipping Addresses [Get Shipping Address](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-shipping-addresses/get-order-shipping-address.md)
- Admin Management: Orders > Order Shipping Addresses [Update Shipping Address](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-shipping-addresses/update-order-shipping-address.md)
- Admin Management: Orders > Order Shipping Addresses Quotes [List Order Shipping Quotes](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-shipping-addresses-quotes/get-order-shipping-address-shipping-quotes.md)
- Admin Management: Orders > Order Status [List Order Statuses](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-status/get-order-statuses.md)
- Admin Management: Orders > Order Status [Get Single Order Status by ID](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-status/get-order-statuses-status.md)
- Admin Management: Orders > Order Taxes [List Order Taxes](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-taxes/get-order-taxes.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/admin/management/orders/openapi.json)
- [OpenAPI YAML](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/openapi.yaml)