# Order Status Update

Order status update for an order can happen from the POS to UrbanPiper or even from UrbanPiper to POS. These status updates are extremely critical for the fulfilment of the orders in real time. For example, when a new order is relayed to your system and the acceptance of the order as the status is not passed within a specified time period, the aggregator may cancel the order. While we provide an API for you to pass the status of the order to our system, any change in the order status in our system will be relayed through the Order Status Update Webhook.

![Order Status Update between POS and UrbanPiper](/files/okyaxN10OnmWBKmYSIlj)

The details of the implementation along with the different status updates are available in the [API document](/downstream/api/endpoints/order-management/order-status-update.md). While you start do put the status of these API and webhook in the Gamma dashboard to *In-Progress* and change it to *To-be-verified* once the same is tested and implemented on your side.

![Order Status Change Feature Update in Gamma](/files/k13zVdD2ShIBDddBcoiF)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-docs.urbanpiper.com/downstream/order/order-status-update.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.