# Orders

Operations related to orders

## List orders

 - [GET /orders](https://hive-merchant-api.redocly.app/merchant-api-v2/mapi_v2_oas31/orders/listorders.md): Returns all orders across all sales channels belonging to the authenticated merchant.

See the Pagination section in the API overview above for details on how pagination works.

## Create a new order

 - [POST /orders](https://hive-merchant-api.redocly.app/merchant-api-v2/mapi_v2_oas31/orders/createorder.md): Creates a new order for a specific sales channel within the merchant's organization.

## Get an order

 - [GET /orders/{id}](https://hive-merchant-api.redocly.app/merchant-api-v2/mapi_v2_oas31/orders/getorder.md): Returns a specific order.

## Partially update an order

 - [PATCH /orders/{id}](https://hive-merchant-api.redocly.app/merchant-api-v2/mapi_v2_oas31/orders/patchorder.md): Partially updates an existing order. Only the provided fields will be updated.

Note: The unique identifiers merchant_order_id and sales_channel_id cannot be
updated and will be ignored if provided in the request body.

## Cancel an order

 - [PUT /orders/{id}/cancel](https://hive-merchant-api.redocly.app/merchant-api-v2/mapi_v2_oas31/orders/cancelorder.md): Cancels an existing order.

## Get an order by merchant order ID and sales channel

 - [GET /orders/by_merchant_order_id](https://hive-merchant-api.redocly.app/merchant-api-v2/mapi_v2_oas31/orders/getorderbymerchantid.md): Returns a specific order using the merchant's order ID and sales channel ID.

## Partially update an order by merchant order ID and sales channel

 - [PATCH /orders/by_merchant_order_id](https://hive-merchant-api.redocly.app/merchant-api-v2/mapi_v2_oas31/orders/patchorderbymerchantid.md): Partially updates an order using the merchant's order ID and sales channel ID.

Note: The unique identifiers merchant_order_id and sales_channel_id cannot be
updated and will be ignored if provided in the request body.

## orderStatusUpdatedWebhook

 - [POST order.status_updated](https://hive-merchant-api.redocly.app/merchant-api-v2/mapi_v2_oas31/orders/orderstatusupdatedwebhook.md)

## orderStatusUpdatedWebhook

 - [POST order.status_updated](https://hive-merchant-api.redocly.app/merchant-api-v2/mapi_v2_oas31/webhooks/orderstatusupdatedwebhook.md)