---
title: "Cancel a disbursement"
method: POST
path: "/facilities/{facility_id}/disbursements/{disbursement_id}/cancel"
tags: ["Facilities"]
---

# Cancel a disbursement

`POST /facilities/{facility_id}/disbursements/{disbursement_id}/cancel`

## Request

- Base URL: `https://production.pier-finance.com/api`
- URL: `https://production.pier-finance.com/api/facilities/{facility_id}/disbursements/{disbursement_id}/cancel`
- Auth: HTTP bearer

Cancels a submitted disbursement before it is sent to the ACH network. Disbursements can only be canceled if they are still in the `pending` state and have not been submitted to the ACH network. After a disbursement is sent to the ACH network, you must wait for the it to settle and then you may refund it instead.

In some cases if you cancel while the disbursement is in the process of being submitted to the ACH network you may see a status of `cancellation_pending` in the response. In this case, you can check the status of the disbursement or wait for a subsequent webhook to see if it was successfully canceled or processed.

## Path parameters

- `facility_id` string, required
- `disbursement_id` string, required

## Response `200`

- Disbursement
  - `id` string, required: The id of the disbursement
  - `facility_id` string, required
  - `amount` integer, required: The amount of the disbursement, in cents (e.g. 1000 = $10.00)
  - `status` 'pending' | 'processing' | 'processed' | 'settled' | 'failed' | 'canceled' | 'cancellation_pending', required
  - `failure_reason` string, nullable: A reason for the failure if any exists
  - `date` string, nullable: The date of the disbursement (YYYY-MM-DD)
  - `created_on` string, date-time, required: Timestamp the disbursement object is created on
  - `transfer_type` 'standard' | 'none' | 'refund' | 'cancellation' | 'suspense_refund', required: Transfer types that are not standard/none are set by special operations like the refund endpoint for example. Special types, like refund, will reference the original transaction transfer type of standard/none to determine if ACH was used if this knowledge is needed (e.g. does an ACH refund need to happen or was this ledgering only).

## Other responses

- `400`
- `401`
- `404`
- `409`
- `429`
- `500`

---

[API](https://skmtc.dev/pier-finance/apis/pier-api.md) - [All operations](https://skmtc.dev/pier-finance/apis/pier-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pier-finance/apis/pier-api/revisions/08a7c49252b9?raw)