# Update Order Status
source: https://developer.mastercard.com/traditional-fulfillment-service/documentation/use-cases/update-order-statuses/index.md

This API is used by external vendor to provide orders status.

## Pre-requisites {#pre-requisites}

Following is the pre-requisite for the customer to use this endpoint:

After an order is initiated by Mastercard with a external vendor for fulfillment, external vendors have the capability to utilize this API to provide updates on the current status of the orders, which will then be communicated back to Mastercard

## Sequence Diagram {#sequence-diagram}

Diagram update-order-statuses

##### Following are the execution steps: {#following-are-the-execution-steps}

1. The external vendor sends a signed request to the Traditional Fulfillment Service for reward items.
2. The request for order update requires the following List of mandatory request parameters :
   * vendor_id in request parameter
   * OrderStatusArray as a part of request body
3. Mastercard API Gateway authenticates/authorizes the customer and routes the request to the Traditional Fulfillment Service in the case of a valid request.
4. The Traditional Fulfillment Service validates the request parameters received via the `/vendors/{vendor_id}/orders/status` endpoint.
5. The Traditional Fulfillment Service updates the order status
6. The Traditional Fulfillment Service sends a response with orders detail (200).
7. The Traditional Fulfillment Service sends a response with a status code of 4xx/5xx in case of an invalid request.

You will receive an error response for an invalid request or any missing request parameter. In that case, you need to update the input and perform step 3 again.

### Endpoint {#endpoint}


API Reference: `GET /vendors/{vendor_id}/orders/status`

Note: For more information about the error codes, refer to the [Code and Formats](https://developer.mastercard.com/traditional-fulfillment-service/documentation/code-and-formats/index.md) section.