> 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 - Hands-on Lab

Lesson 20 of 26 · 45 min

Orders API

### **In this lab, you will:**

* Create an order with an existing simple product
* GET an order
* Update an order
* GET a count of orders

### Prerequisites

* BigCommerce store (sandbox or live)
* Basic knowledge of APIs
* REST client (Postman)

## Create An Order with An Existing Simple Product

1. **Copy** and **paste** the request below into Postman

```http showLineNumbers={false}
https://api.bigcommerce.com/stores/{{store_hash}}/v2/orders
```

> **Info**
>
> If you created your environment correctly in the previous lab, `{{store_hash}}` will use your store's store hash automatically.

2. **Copy** and **paste** the code below into the body section of Postman

```json showLineNumbers={false}
{
    "products": [
        {
            "product_id": {simple_product_id},
            "quantity": 1
        }
        ],
    "billing_address": {
    "first_name": "API",
    "last_name": "Order",
    "company": "",
    "street_1": "123 Main Street",
    "street_2": "",
    "city": "Austin",
    "state": "Texas",
    "zip": "78704",
    "country": "United States",
    "country_iso2": "US",
    "phone": "5555555555",
    "email": "api.order@email.com"
    }
}
```

3. **Replace** `{simple_product_id}` with the ID of a simple product in the store
4. **Select** POST next to the request URL
5. **Click** the Send button
6. **Observe** response

![Image](/_fern-img/5bc12c8fcb8e3c09335b6f533664924abf80d28e47ffda048f82411a19acda06.webp)

## GET an Order

1. **Copy** and **paste** the request below into Postman

```http showLineNumbers={false}
https://api.bigcommerce.com/stores/{{store_hash}}/v2/orders/{order_id}
```

> **Info**
>
> If you created your environment correctly in the previous lab, `{{store_hash}}` will use your store's store hash automatically.

2. **Replace** `{order_id}` with the id of the order created in the previous steps
3. **Select** GET next to the request url
4. **Click** the Send button
5. **Observe** the response

![Image](/_fern-img/138a1bc0f70e37af64fbff40570089349f6fde86c81cf254f541dfe858d5a44d.webp)

## Update an Order (Update Billing Address)

1. **Copy** and **paste** the request below into Postman

```http showLineNumbers={false}
https://api.bigcommerce.com/stores/{{store_hash}}/v2/orders{orders_id}
```

2. **Replace** `{order_id}` with the id of the order created in previous steps
3. **Copy** and **paste** the code below into the body section of Postman

```json showLineNumbers={false}
{
    "billing_address": {
    "street_1": "321 different Street"
    }
}
```

4. **Select** PUT next to the request url
5. **Click** the Send button
6. **Observe** the response and address updated

![Image](/_fern-img/758d0d25590bcc5540eded03b2b27ce7c03a47c61b89f18ddb7c4b40fd1a9d35.webp)

## GET a Count of Orders

1. **Copy** and **paste** the request below into Postman

```http showLineNumbers={false}
https://api.bigcommerce.com/stores/{{store_hash}}/v2/orders/count
```

2. **Select** GET next to the request URL
3. **Click** the Send button
4. **Observe** response

![Image](/_fern-img/f1080d9e97ad5f1fa3bd2cae00f1dc5492a4f58960080d1929d22515a3c0503a.webp)