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

Lesson 12 of 26 · 15 min

Each order status represents a state in the order-fulfillment workflow.

When moving through order management, the order status is not automatically updated. This needs to be changed as needed. You can specify status\_id, which will automatically set the corresponding status. When status\_id is not specified, it will be automatically set to 1, which will set status to Pending.

The following statuses are of the paid type:

| Status ID | Name                         | Description                                                                                                 |
| --------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------- |
| 0         | Incomplete                   | An incomplete order happens when a shopper reached the payment page, but did not complete the transaction.  |
| 1         | Pending                      | Customer started the checkout process, but did not complete it.                                             |
| 2         | Shipped                      | Order has been shipped, but receipt has not been confirmed; seller has used the Ship Items action.          |
| 3         | Partially shipped            | Only some items in the order have been shipped, due to some products being pre-order only or other reasons. |
| 4         | Refunded                     | Seller has used the Refund action.                                                                          |
| 5         | Cancelled                    | Seller has cancelled an order, due to a stock inconsistency or other reasons.                               |
| 6         | Declined                     | Seller has marked the order as declined for lack of manual payment, or other reasons.                       |
| 7         | Awaiting payment             | Customer has completed checkout process, but payment has yet to be confirmed.                               |
| 8         | Awaiting pickup              | Order has been pulled, and is awaiting customer pickup from a seller-specified location.                    |
| 9         | Awaiting shipment            | Order has been pulled and packaged, and is awaiting collection from a shipping provider.                    |
| 10        | Completed                    | Client has paid for their digital product and their file(s) are available for download.                     |
| 11        | Awaiting fulfillment         | Customer has completed the checkout process and payment has been confirmed.                                 |
| 12        | Manual Verification Required | Order is on hold while some aspect needs to be manually confirmed.                                          |
| 13        | Disputed                     | Customer has initiated a dispute resolution process for the PayPal transaction that paid for the order.     |
| 14        | Partially refunded           | Seller has partially refunded the order.                                                                    |

BigCommerce considers all statuses other than those above to be of the unpaid type, except Refunded, which is considered neither paid or unpaid. Setting orders to certain statuses triggers notification emails.

## List Order Statuses

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

## Custom Order Status

The order status label can be changed in the Control Panel. This does not change the underlying functionality. See our support article on Order Status.

## Resources:

* [Order Statuses](/developer/api-reference/rest/admin/management/orders)