---
title: "Cancel a specific Mandate"
method: POST
path: "/directdebits/cancel"
tags: ["Direct Debit Outbound Mandate Operations"]
---

# Cancel a specific Mandate

`POST /directdebits/cancel`

Used to request the cancellation of a Mandate.

## Request body

- DirectdebitoutboundMandateCancelRequest — Details of the Mandate Cancel Request
  - `mandateId` string, required — Mandate Id
  - `accountId` string, required — Account Id
  - `cancellationCode` 'REFER_TO_PAYER' | 'INSTRUCTION_CANCELLED_BY_PAYER' | 'PAYER_DECEASED' | 'ACCOUNT_TRANSFERRED' | 'ACCOUNT_CLOSED' | 'ACCOUNT_OR_INSTRUCTION_TRANSFERRED' | 'ADVANCE_NOTICE_DISPUTED' | 'INSTRUCTION_AMENDED' | 'INSTRUCTION_REINSTATED', required — Cancellation Code
  - `merchantNumber` string, required — Merchant Number

## Response `200`

Mandate was successfully cancelled

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/modulrfinance/apis/modulr-api.md) · [All operations](https://skmtc.net/modulrfinance/apis/modulr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modulrfinance/modulr-api/revisions/cbd52524c8ef/schema)