---
title: "Changes the main state of a single order"
method: PUT
path: "/api/v1/orders/{id}/orderstate"
tags: ["Orders"]
---

# Changes the main state of a single order

`PUT /api/v1/orders/{id}/orderstate`

### REMARKS ###
Use this call to change the state of an order to i.e. paid or sent.

The state is transfered to the external shop/marketplace if configured.
This is the list of known states:
- 1: ordered
- 2: confirmed
- 3: paid
- 4: shipped
- 5: reclamation
- 6: deleted
- 7: closed
- 8: canceled
- 9: archived
- 10: not used
- 11: demand note 1
- 12: demand note 2
- 13: packed
- 14: offered
- 15: payment reminder
- 16: fulfilling

## Path parameters

- `id` integer, required

## Request body

- RechnungsdruckWebAppControllersApiOrderStateUpdate — Specifies the parameters used to set the new state of an order
  - `NewStateId` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 — The new state to set

## Response `200`

OK

- object

---

[API](https://skmtc.dev/billbee/apis/billbee-api.md) · [All operations](https://skmtc.dev/billbee/apis/billbee-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/billbee/billbee-api/revisions/e64f07f4f526/schema)