> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.coi.co.il/orders/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.coi.co.il/_mcp/server.

# Overview

The store's orders. Permission: **orders** (read, or read and update).

* **List / get** - each order in full: the customer, the products with their options, delivery, coupon, promotions, VAT, the total, and every field filled in at checkout. Filter by `status`, `paid`, `created_since` and `created_until`.
* **Update** - the status, paid, notes, and the shipment's **tracking number**. With `notifyCustomer: true`, the customer gets the store's "order status changed" email, including the tracking number.

Statuses are the store's own (admin: **הזמנות > נהל סטטוסים**); 1 is "new" and 2 is "read". Sending a status id the store does not have is answered with the list of valid ones.

To be told about new orders as they happen rather than polling, use the [Order Placed webhook](/webhooks/order-placed-payload).


## API Docs

- Orders [List orders](https://docs.coi.co.il/orders/list-orders.md)
- Orders [Get an order](https://docs.coi.co.il/orders/get-order.md)
- Orders [Update an order](https://docs.coi.co.il/orders/update-order.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.coi.co.il/orders/openapi.json)
- [OpenAPI YAML](https://docs.coi.co.il/orders/openapi.yaml)