---
title: "Cancel a payout"
method: DELETE
path: "/api/payout/{payoutId}"
tags: ["Payouts"]
---

# Cancel a payout

`DELETE /api/payout/{payoutId}`

Cancels a payout that has not yet been submitted on-chain. Only payouts in the `INITIATED` status can be cancelled. Payouts in `PENDING_APPROVALS`, `SENT`, `COMPLETED` or terminal failure states cannot be cancelled via this endpoint.

## Path parameters

- `payoutId` string, required

## Response `204`

Payout cancelled successfully

## Other responses

- `400` — Payout is not in a cancellable state
- `401` — Unauthorized - Invalid API key
- `404` — Payout not found

---

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