---
title: "Update Order Status"
method: POST
path: "/orders/{yelp_order_id}/confirmation_status/v3"
tags: ["Checkout API"]
---

# Update Order Status

`POST /orders/{yelp_order_id}/confirmation_status/v3`

**This API is only for specific food partners.**

This allows a status update to an order. This call returns a status code which indicates if the request was successful.

A notification will not be sent in the following scenarios:
* The order was made over 3 hours ago
* The same notification (same `yelp_order_id` and the `confirmation_type`) has already been sent
* An ETA is provided and the notification is being sent past the ETA
* An `order_confirmed` update is trying to be sent after a `deliver_in_progress` notification

## Parameters

- `#/paths/~1orders~1%7Byelp_order_id%7D~1update~1v3/put/parameters/0` — unresolved $ref

## Request body

- object
  - `confirmation_type` object, required — [ConfirmationType](https://docs.developer.yelp.com/docs/resources#confirmationtype-enum) enum. The state the order is being updated to.
  - `eta_in_minutes` integer, required — The estimated time of arrival.

## Response `200`

Successfully updated the order status.

- object

## Other responses

- `403` — This error is returned in any of the following scenarios: | Status | error_code | error_message (example) | ------- | --------------------- | ------------------------------ | 403 | ORDER_STATE_INVALID | Order is in an invalid state to perform this operation.

---

[API](https://skmtc.net/yelp/apis/businesses.md) · [All operations](https://skmtc.net/yelp/apis/businesses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yelp/businesses/revisions/d3f744f55ed7/schema)