> For the complete documentation index, see [llms.txt](https://fincart.gitbook.io/fincart-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fincart.gitbook.io/fincart-api/apis/cancel-orders.md).

# 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>](/fincart-api/access/access-token.md) |

**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 %}