Update order status using API in Magento 2

Posted by

In Magento and Adobe commerce the REST API provides a powerful way to interact with the system programmatically. One common task is update order status, which allows you to keep track of the progress and fulfilment of orders. In this article, we will explore how to update the order status using the REST API in Magento.

Understanding the Order Status in Magento rest api

The order status represents the current state of an order, such as “Pending,” “Processing,” “Complete,” etc. Each status has a corresponding label and can trigger specific actions or notifications within the system.

Configuring the REST API in Magento 2

Before using the REST API, ensure that you have the necessary access credentials and permissions. Create a REST API integration and obtain the access token required for authentication.

Updating the Order Status

Make a POST request to the endpoint: POST /rest/V1/orders. Include the updated order data in the request body, specifying the new order status. Before making this request you need to get the access token. You can learn how to generate access token from here https://learningmagento.com/create-access-token-in-magento/

Request Example

  • Request API URI: https://example.com/rest/V1/orders
  • Request Method: POST
  • Request Headers:
    • Authorization: Bearer {access_token}
    • Content-Type: application/json
  • Request Body (JSON format):
  "entity": {
    "entity_id": {orderId},
    "state": "processing",
    "status": "processing"

Response and Error Handling

Upon a successful update, the API will return a response with the updated order data. Handle any potential errors or exceptions that may occur during the update process. Utilize the error codes and messages provided by the API to troubleshoot and resolve any issues.

Conclusion for Update order status

Updating the order status using the REST API in Magento 2 offers a convenient way to automate and manage order processing. By understanding the order status concept, configuring REST API access, and following the correct request format, you can easily update order statuses programmatically. This capability provides flexibility and control over the order fulfilment process, enhancing the overall efficiency of your store.

Remember to refer to the API documentation for detailed specifications and guidelines when working with the REST API.


This article is for informational purposes only and does not cover all aspects and variations of working with the REST API in Magento 2. It’s recommended to refer to official documentation and consult Magento experts for comprehensive guidance.

I hope this article helps you understand how to update order status using the REST API in Magento. If you have any further questions or need assistance, feel free to reach out.

Leave a Reply

Your email address will not be published. Required fields are marked *