> For the complete documentation index, see [llms.txt](https://docs-card.musepay.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-card.musepay.io/reference/api-reference/fiat-payout-api/quotations.md). # Payout Quote {% hint style="warning" %} Every request must contain [common parameters](/reference/api-reference/common-parameters.md). {% endhint %} Creates a quote for converting the source asset into the fiat currency received by the beneficiary. The beneficiary and payout route are captured when the quote is created. `POST` `/v1/fiatpayout/payouts/quote` ## Request Body | Name | Type | Required | Description | | ------------------------- | ------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | request\_id | String | Yes | Unique identifier supplied by the organization. Used as the quote request's idempotency key. | | quote\_mode | String | Yes | Quote mode. Use `source` to specify `pay_amount`, or `dest` to specify `receive_amount`. | | pay\_currency | String | Yes | Source asset code. | | pay\_amount | String | Conditional | Source amount. Required when `quote_mode` is `source`; must be greater than zero. | | receive\_currency | String | Yes | Fiat currency received by the beneficiary, as an ISO 4217 currency code. | | receive\_amount | String | Conditional | Destination amount. Required when `quote_mode` is `dest`; must be greater than zero. | | beneficiary\_country | String | Yes | Beneficiary country or region as an ISO 3166-1 alpha-2 code. | | beneficiary\_bank\_id | String | Yes | `bank_code` returned by [Supported Banks](/reference/api-reference/fiat-payout-api/capabilities/banks.md). | | account\_type | String | Yes | Beneficiary account type: `PERSONAL` for an individual or `ENTERPRISE` for an organization. | | beneficiary\_relationship | String | Yes | Beneficiary relationship: `own` or `third`. | | clear\_network | String | Yes | Clearing network returned by [Supported Networks](/reference/api-reference/fiat-payout-api/capabilities/networks.md). | | beneficiaryFields | Object | No | Bank-specific fields keyed by the values returned from [Required Beneficiary Fields](/reference/api-reference/fiat-payout-api/capabilities/fields.md). The field name is case-sensitive. | | individual\_beneficiary | Object | Conditional | Required when `account_type` is `PERSONAL`. | | enterprise\_beneficiary | Object | Conditional | Required when `account_type` is `ENTERPRISE`. | Provide only the beneficiary object that matches `account_type`. ### Beneficiary Fields The following fields apply to both `individual_beneficiary` and `enterprise_beneficiary`: | Name | Type | Required | Description | | ----------- | ------ | -------- | -------------------------------- | | account\_no | String | Yes | Beneficiary bank account number. | | bank\_name | String | Yes | Beneficiary bank name. | | address | String | Yes | Beneficiary address. | Additional fields for `individual_beneficiary`: | Name | Type | Required | Description | | --------------- | ------ | -------- | ------------------------------------------------------------------------------- | | full\_name | String | No | Full legal name. When present, it is used as the beneficiary name. | | first\_name | String | No | Given name. Used with `middle_name` and `last_name` when `full_name` is absent. | | middle\_name | String | No | Middle name. | | last\_name | String | No | Family name. | | nationality | String | No | Nationality as an ISO 3166-1 alpha-2 code. | | gender | String | No | `male` or `female`. | | date\_of\_birth | String | No | Date of birth in `yyyy-MM-dd` format. | Additional field for `enterprise_beneficiary`: | Name | Type | Required | Description | | ------------- | ------ | -------- | ------------------------ | | company\_name | String | No | Legal organization name. | ## Request Example ```json { "request_id": "request-1", "quote_mode": "source", "pay_currency": "USDT", "pay_amount": "100.00", "receive_currency": "USD", "beneficiary_country": "US", "beneficiary_bank_id": "bank-1", "account_type": "PERSONAL", "beneficiary_relationship": "third", "clear_network": "ACH", "beneficiaryFields": { "routing_number": "110000" }, "individual_beneficiary": { "account_no": "123456789", "bank_name": "Example Bank", "address": "New York", "full_name": "Alice Smith" } } ``` ## Response Body | Name | Type | Description | | ----------------- | ------ | ----------------------------------------------------------------------------- | | request\_id | String | Identifier supplied in the quote request. | | order\_no | String | Quote order number generated by MusePay. Use this value to create the payout. | | transaction\_time | Number | Quote creation time, as a 13-digit Unix timestamp in milliseconds. | | quote\_mode | String | Quote mode used for the request. | | pay\_amount | String | Amount deducted from the source balance. | | pay\_currency | String | Source asset code. | | fee\_amount | String | Payout fee. | | fee\_currency | String | Currency in which the fee is charged. | | exchange\_rate | String | Exchange rate from `pay_currency` to `receive_currency`. | | receive\_amount | String | Fiat amount received by the beneficiary. | | receive\_currency | String | Beneficiary currency. | | expire\_time | Number | Quote expiration time, as a 13-digit Unix timestamp in milliseconds. | ```json { "code": "200", "message": "success", "data": { "request_id": "request-1", "order_no": "ORDER-1", "transaction_time": 1700000000000, "quote_mode": "source", "pay_amount": "100.00", "pay_currency": "USDT", "fee_amount": "1.25", "fee_currency": "USDT", "exchange_rate": "0.99", "receive_amount": "98.75", "receive_currency": "USD", "expire_time": 1700000900000 } } ```