# Payouts

The Payouts API allows merchants to send money to their payees securely and efficiently. 
You can create new payouts, check their status, and cancel them if needed before processing. 
Each payout is linked to a registered payee and a payout account. 
The API supports listing all payouts with optional filters like status. 
Responses include detailed information about the payout, such as amount, currency, and current status. 
Use this API to manage your outgoing payments in a reliable and predictable way.

## Initiates a payout to a payee.

 - [POST /v1/payouts](https://docs.theropay.cloud/theropay/docs/reference/api/payouts/paths/~1v1~1payouts/post.md): The payout is processed asynchronously. Use GET /v1/payouts/{id} to check its status.  
Required fields: PayeeId, Amount, Currency.  
Optional field: Description.
MerchantId is automatically obtained from the authenticated user.

## Retrieves a list of payouts for a specific payee.

 - [GET /v1/payouts](https://docs.theropay.cloud/theropay/docs/reference/api/payouts/paths/~1v1~1payouts/get.md)

## Retrieves details of a specific payout by unique reference.

 - [GET /v1/payouts/{PayoutUniqueReference}](https://docs.theropay.cloud/theropay/docs/reference/api/payouts/paths/~1v1~1payouts~1%7Bpayoutuniquereference%7D/get.md)

## Requests cancellation of a pending payout.

 - [POST /v1/payouts/{PayoutUniqueReference}/cancel](https://docs.theropay.cloud/theropay/docs/reference/api/payouts/paths/~1v1~1payouts~1%7Bpayoutuniquereference%7D~1cancel/post.md): Only payouts not yet processed can be cancelled.  
Completed or failed payouts cannot be cancelled.