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

# Refund a disbursement

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

## Request

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

Refunds a specified disbursement in full. This endpoint is intended for correcting erroneous transactions.

## Path parameters

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

## Response `200`

- RefundedDisbursement
  - `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)