---
title: "POST /v3/payout/quote"
method: POST
path: "/v3/payout/quote"
---

# POST /v3/payout/quote

`POST /v3/payout/quote`

## Request body

- object
  - `payout_type` string, required — Type of the payout. Possible values - `swift`, `local`, `local_payment_network`, `wallet`, `tazapay_account`
  - `local` object — Object containing additional details if the payout_type is local
    - `fund_transfer_network` string — Type of the fund_transfer_network (example - chats in HK).
  - `holding_info` object — Amount in balance (holding) currency
    - `amount` integer — Amount in cents. For decimal currency handling, refer to <a href = '/API-Reference/appendix/Decimal-Currencies'>this</a>.
    - `currency` string, required — Currency - in ISO format
  - `payout_info` object, required — Amount in payout currency
    - `amount` integer, required — Amount in cents. For decimal currency handling, refer to <a href = '/API-Reference/appendix/Decimal-Currencies'>this</a>.
    - `currency` string, required — Currency - in ISO format
  - `destination_info` object — Amount in destination currency (currency in which beneficiary receives the funds)
    - `amount` integer — Amount in cents. For decimal currency handling, refer to <a href = '/API-Reference/appendix/Decimal-Currencies'>this</a>.
    - `currency` string, required — Currency - in ISO format
    - `country` string, required — Two letter country code - in ISO format / Represents beneficiary bank country
  - `local_payment_network` object — Object containing additional details if the payout type is local_payment_network
    - `type` string — Type of the local payment network
  - `wallet` object — Object containing additional details if the payout type is wallet
    - `type` string — Type of the wallet (or blockchain)
  - `swift` object — Object containing additional details if the payout_type is `swift
    - `charge_type` string — `shared` or `ours`
  - `entity_id` string — Unique identifier of the entity. Must be 24 characters and start with `ent_`.

## Response `200`

- object
  - `id` string — Unique identifier for the payout quote
  - `object` string — Type of the object
  - `payout_type` string — Type of payout (e.g., local, swift)
  - `holding_info` object — Details about the holding currency and amount
    - `currency` string — Currency of the holding balance
    - `amount` number — Amount available in holding currency
  - `payout_info` object — Information about payout currency and amount
    - `currency` string — Currency of the payout
    - `amount` number — Payout amount in payout currency
  - `destination_info` object — Information about destination currency and amount
    - `currency` string — Currency of the destination
    - `amount` number — Amount received in destination currency
  - `fee_info` object — Breakdown of fixed and variable fees
    - `fixed` object — Fixed fee details
      - `in_holding_currency` number — Fixed fee amount in holding currency
      - `in_payout_currency` number — Fixed fee amount in payout currency
    - `variable` object — Variable fee details
      - `in_holding_currency` number — Variable fee amount in holding currency
      - `in_payout_currency` number — Variable fee amount in payout currency
  - `exchange_rates` object — Exchange rates used in the payout quote
    - `holding_to_payout` number — Exchange rate from holding to payout currency
    - `payout_to_destination` number — Exchange rate from payout to destination currency
  - `valid_until` string — Timestamp until which the quote is valid (ISO 8601 format)
  - `status` string — Status of the payout quote
  - `created_at` string — Timestamp when the payout quote was created
  - `updated_at` string — Timestamp when the payout quote was last updated

---

[API](https://skmtc.net/tazapay/apis/sandbox.md) · [All operations](https://skmtc.net/tazapay/apis/sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tazapay/sandbox/revisions/bf5f4b8f6f5d/schema)