---
title: "Cancel a transfer"
method: POST
path: "/transfers/{id}"
tags: ["transfers"]
---

# Cancel a transfer

`POST /transfers/{id}`

Cancel a pending transfer by setting its status to cancelled. Only transfers in pending status can be cancelled before processing begins. Returns the updated transfer resource with cancelled status. Use this endpoint to stop a bank transfer from further processing.

## Path parameters

- `id` string, required

## Headers

- `Accept` 'application/vnd.dwolla.v1.hal+json', required

## Request body

- object
  - `status` 'cancelled', required

## Response `200`

successful operation

## Other responses

- `400` — 400 Bad Request
- `404` — 404 Not Found

## Changes

- **2025-07-01** `8a20e7000645` — 1 breaking
  - the `status` request property const value `cancelled` was added
- **2025-06-06** `231d0268586b` — 1 breaking, 8 info
  - request body became required
  - the response property `code` became required for the status `404`
  - the response property `message` became required for the status `404`
  - the response property `oneOf[subschema #1: BadRequestError]/code` became required for the status `400`
  - …5 more
- **2025-05-23** `4c8b16e05918` — 1 breaking
  - added the new required `header` request parameter `Accept`

[Change history](https://skmtc.dev/dwolla/apis/dwolla-api/changes/transfers/:id/post.md)

---

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