> 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.

# Order Shipping Address

Lesson 13 of 26 · 30 min

Retrieve or update a shipping address associated with an order.

* If a shipping address is not provided, it defaults to the billing address.
* The shipping address is input as an array object since more than one shipping address can be added at a time. Adding multiple shipping addresses allows for an order to ship to multiple locations.
* When adding shipping addresses during an order **PUT** or **POST** request, the API will allow you to add more than is necessary.

## Update an order's shipping address

Update or add a shipping address to an existing order with a **PUT** request to: `/orders/{order_id}`

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

![Image](/_fern-files/bigcommerce.docs.buildwithfern.com/109235db2b9f8a581facd1b32cdd42028bd8be4129fcd17109edca435e3e868e/assets/learn/checkout-orders-rest-api/addShipping_request.png)

![Image](/_fern-files/bigcommerce.docs.buildwithfern.com/b8369026598829c2830f64f1d0b44a0b0255d0dc6eac997f35498d2802f314dd/assets/learn/checkout-orders-rest-api/addShippingResponse.png)

## GET a List of Order Shipping Addresses

GET all shipping addresses on an order using the `order_id` by sending a request to: `/orders/{order_id}/shipping_addresses`

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

## GET a Shipping Address

GET a single shipping addresses associated with an order with the id of the shipping address: `/orders/{order_id}/shipping_addresses/{id}`

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

> **Info**
>
> Returned in the response is `shipping_quotes` object. Please use the Get Shipping Quotes Endpoint. Using the response will return a 204 for the shipping quote.

## Resources:

* [Order Shipping Address](/developer/docs/admin/checkout-and-cart/orders/overview#including-shipping-addresses)