---
title: "Cancel a mandate"
method: POST
path: "/mandates/{mandate_id}/cancel"
tags: ["Direct Debit"]
---

# Cancel a mandate

`POST /mandates/{mandate_id}/cancel`

This API endpoint allows for the immediate cancellation of a mandate. Any custom data supplied to this endpoint will be linked to the resulting mandate cancellation event. Please be aware that this process will fail if the mandate is not in an active status. Once a mandate has been cancelled, it cannot be reverted to an `active` status, in this case a new mandate must be created.

## Path parameters

- `mandate_id` string, uuid, required

## Headers

- `Company-Id` string, uuid
- `Mid` string, uuid

## Request body

- object
  - `custom_data` string, required — Assign a base64 encoded reason to your cancellation request. This field is required as we pass the value from this field downstream to our Direct Debit provider who require a cancellation reason.

## Response `200`

OK

- object
  - `status` 'success' — The outcome of the request

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `409` — Conflict

---

[API](https://skmtc.dev/acquired/apis/acquired-api.md) · [All operations](https://skmtc.dev/acquired/apis/acquired-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/acquired/acquired-api/revisions/7ae178a046f2/schema)