---
title: "Cancel draft transfer"
method: DELETE
path: "/v2/business-accounts/draft-transfers/{draftTransferId}"
tags: ["Draft Transfers API"]
---

# Cancel draft transfer

`DELETE /v2/business-accounts/draft-transfers/{draftTransferId}`

> 🚧 Beta feature
>
> This feature is currently in beta testing, and the final specification may still change.

Cancels a draft transfer created via this API. Transitions the draft transfer to `declined` with
`statusReason.code` set to `deleted-by-creator`.

Only draft transfers created via this API, and still in `pending-review`, can be cancelled this way. A
`422` is returned if the initiator has already started approving it.

In test mode, this always returns a synthetic `declined` draft. See [Create draft
transfer](create-draft-transfer) for how to simulate `approved` and `declined` outcomes.

## Headers

- `idempotency-key` string

## Request body

- object
  - `testmode` boolean, nullable — Most API credentials are specifically created for either live mode or test mode, in which case this parameter must not be sent. For organization-level credentials such as OAuth access tokens, you can enable test mode by setting `testmode` to `true`. Test entities cannot be retrieved when the endpoint is set to live mode, and vice versa.

## Response `200`

The cancelled (declined) draft transfer object.

## Other responses

- `404` — No entity with this ID exists.
- `422` — The draft transfer cannot be cancelled. Only draft transfers with status `pending-review` can be cancelled.
- `429` — Rate Limit has been reached.

---

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