# Cancel Orders

This documentation guides you through the process of canceling a one or more `pending` order within the Fincart platform. By specifying the order ID, merchants can update the order status to canceled.

## Get Order Status

<mark style="color:yellow;">`POST`</mark> `/v4/orders/cancel`

This endpoint allows you to change  order status to canceled.&#x20;

<details>

<summary>Base URL</summary>

[https://api.fincart.io](https://api.fincart.io/)

</details>

**Headers**

| Name          | Value                                                                                                    |
| ------------- | -------------------------------------------------------------------------------------------------------- |
| Content-Type  | `application/json`                                                                                       |
| Authorization | [<mark style="color:blue;">`<token>`</mark>](https://fincart.gitbook.io/fincart-api/access/access-token) |

**Body**

```json
{
  "filters": {
    "ids": ["<order_id_1>", "<order_id_2>", "..."]
  }
}
```

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "statusCode": 200,
    "message": "Bulk Orders cancelled successfully",
    "data": {
        "status": "success",
        "msg": "Orders have been successfully canceled."
    }
}
```

{% endtab %}

{% tab title="403" %}

```json
{
    "statusCode": 403,
    "timestamp": "2025-07-16T15:29:54.151Z",
    "path": "/v4/orders/cancel",
    "message": "User is not authorized",
    "errors": [
        "User is not authorized"
    ]
}
```

{% endtab %}
{% endtabs %}