---
title: "Create a quote for the payout"
method: POST
path: "/v3/payouts/{payoutId}/quote"
tags: ["Payouts"]
---

# Create a quote for the payout

`POST /v3/payouts/{payoutId}/quote`

Create quote for a payout

## Path parameters

- `payoutId` string, uuid, required

## Response `200`

Quote for payout

- QuoteResponseV3
  - `fxSummaries` QuoteFxSummaryV3[]
    - `rate` number, float, required — The conversion rate (from the source currency to the payment currency)
    - `invertedRate` number, float — The inverse conversion rate (from paymnent currency to source currency)
    - `creationTime` string, date-time, required — Timestamp of when the quote was created
    - `expiryTime` string, date-time — The timestamp for when the quote will expire
    - `quoteId` string, uuid, required — The id of the created quote
    - `totalSourceAmount` integer, required — The amount (in minor units) that will be paid from the source account
    - `totalPaymentAmount` integer, required — The amount (in minor units) that the payee will receive
    - `sourceCurrency` string, required — Valid ISO 4217 3 letter currency code. See the <a href="https://www.iso.org/iso-4217-currency-codes.html" target="_blank" a>ISO specification</a> for details.
    - `paymentCurrency` string, required — Valid ISO 4217 3 letter currency code. See the <a href="https://www.iso.org/iso-4217-currency-codes.html" target="_blank" a>ISO specification</a> for details.
    - `fundingStatus` string, required — Current status of the funding associated with this quote. One of the following values: UNFUNDED, INSTRUCTED, FUNDED
    - `status` string, required — Current status of the fx quote. One of the following values: UNQUOTED, QUOTED, EXPIRED, EXECUTED, REJECTED

## Other responses

- `404` — The resource was not found or is no longer available
- `409` — The request contained data that would result in a duplicate value

## Changes

- **2022-12-22** `2c03ca69ee09` — 2 info
  - api tag `Payouts` added
  - api tag `Payout Service` removed
- **2022-06-27** `1e7a1734a45c` — 8 info
  - removed the `EXECUTED` enum value from the `fxSummaries/items/status` response property for the response status `200`
  - removed the `EXPIRED` enum value from the `fxSummaries/items/status` response property for the response status `200`
  - removed the `FUNDED` enum value from the `fxSummaries/items/fundingStatus` response property for the response status `200`
  - removed the `INSTRUCTED` enum value from the `fxSummaries/items/fundingStatus` response property for the response status `200`
  - …4 more
- **2020-09-25** `dd71433847a6` — 2 breaking, 12 info
  - the `errors/items/` response's property type changed from no type to `object` for status `404`
  - the `errors/items/` response's property type changed from no type to `object` for status `409`
  - added the optional property `errors/items/errorCode` to the response with the `404` status
  - added the optional property `errors/items/errorCode` to the response with the `409` status
  - …10 more
- **2020-06-24** `aded220b0d7b` — 2 breaking, 3 info
  - the response's body type changed from `object` to no type for status `404`
  - the `errors/items/` response's property type changed from `object` to no type for status `404`
  - api operation id `createQuoteForPayoutV3` was added
  - api tag `Payout Service` added
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/changes/v3/payouts/:payoutId/quote/post.md)

---

[API](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis.md) · [All operations](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/revisions/c9570437d66c?raw)