---
title: "Request bank payout"
method: POST
path: "/money/payout_requests"
tags: ["money", "payouts"]
---

# Request bank payout

`POST /money/payout_requests`

## Request

- Base URL: `https://api.stablesea.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stablesea.com/money/payout_requests`
- Auth: none declared. Required headers: `Idempotency-Key`

Requests a bank payout for an immutable quote. Returns approval_pending with a saved request, or created with a recorded movement. A pending request has no movement ID and has not executed. Reconcile uncertain responses using the original Idempotency-Key at GET /money/payout_submissions. Gated on PermKYBLocked + PermFundsWithdraw.

## Headers

- `Idempotency-Key` string, required: Required client idempotency key; a duplicate submission with the same key is rejected with 409.

## Request body

- PayoutsCreatePayoutInput
  - `purpose` 'supplier' | 'payroll' | 'physical_goods' | 'digital_goods' | 'other_services' | 'property_rental' | 'logistics' | 'taxes' | 'insurance' | 'remittances' | 'investment' | 'charity_donation' | 'tuition_costs' | 'medical_care' | 'family_maintenance' | 'pension' | 'utility_provider' | 'public_services' | 'property_purchase' | 'travel' | 'tourism_expense' | 'entertainment' | 'affiliation_programs' | 'rewards' | 'savings_retirement' | 'investment_interest' | 'shares' | 'availability' | 'capital_contribution', required
  - `quote_id` string

## Response `200`

OK

- PayoutsPayoutRequestOutput
  - `complete` boolean
  - `created_ts` string, date-time
  - `money_movement_id` string
  - `outcome` 'created' | 'approval_pending', required
  - `transfer_approval_id` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `501`: Not Implemented
- `503`: Service Unavailable
- `default`: Error response.

## Changes

- **2026-11-14** `b7bb96769c1b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/money/payout_requests/post.md)

---

[API](https://skmtc.dev/stablesea/apis/stable-sea-backend.md) - [All operations](https://skmtc.dev/stablesea/apis/stable-sea-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/stablesea/apis/stable-sea-backend/revisions/b7bb96769c1b?raw)