--- title: "Create a quote (unauthenticated)" method: POST path: "/v3/quotes" tags: ["quote"] --- # Create a quote (unauthenticated) `POST /v3/quotes` Use this endpoint to get example quotes for people to see the exchange rate and fees Wise offers before a user has created or linked an account. This can drive a version of the quote screen that shows the user what Wise offers before they sign up. Note that this endpoint does not require a token to create the resource, however, since it is just an example, the returned quote has no ID so can't be used later to create a transfer. In order to get an accurate partner fee, we require a client credentials token to be provided. If you are a partner and would like your fee to be included in the quote returned, you must provide your auth token. If not, you do not require the Authorization header. {% admonition type="info" %} Unauthenticated quotes cannot be used to create transfers, they are meant for illustration purposes in partner interfaces only. Make sure to create an authenticated quote during the transfer creation flow. {% /admonition %} ## Headers - `X-External-Correlation-Id` string, uuid ## Request body - object - `sourceCurrency` string, required — Source (sending) currency code. - `targetCurrency` string, required — Target (receiving) currency code. - `sourceAmount` number, nullable — Amount in source currency. Either sourceAmount or targetAmount is required, never both. - `targetAmount` number, nullable — Amount in target currency. - `pricingConfiguration` object — Required when configured for your client ID. Includes a pricingConfiguration to be used for pricing calculations with the quote. - `fee` object - `type` string — Identifies the type of fee that will be configured. Options include only `OVERRIDE`. - `variable` number — The selected variable percentage (in decimal format) that should be used in the pricingConfiguration. - `fixed` number — The selected fixed fee that should be used in the pricingConfiguration. Always considered in source currency. ## Response `200` Returns a quote object. - Quote - `id` string, uuid — ID of this quote (GUID format). - `sourceCurrency` string — Source (sending) currency code. - `targetCurrency` string — Target (receive) currency code. - `sourceAmount` number — Amount in source currency to send. - `targetAmount` number — Amount in target currency to be received by the recipient. - `payOut` string — Mechanism we use to deliver the transfer. Not usually of interest to the user. - `preferredPayIn` string — Preferred pay-in method. - `rate` number — Exchange rate value used for the conversion. - `createdTime` string, date-time — Quote created timestamp. - `user` integer — User ID who created the quote. - `profile` integer — Personal or business profile ID. - `rateType` 'FIXED' | 'FLOATING' — Whether the rate is fixed or floating. - `rateExpirationTime` string, date-time — Time the locked rate will expire. - `guaranteedTargetAmountAllowed` boolean — Whether guaranteed target amount is allowed. - `targetAmountAllowed` boolean — Whether target amount is allowed. - `guaranteedTargetAmount` boolean — Whether the target amount is guaranteed. - `providedAmountType` 'SOURCE' | 'TARGET' — Whether the quote was created as source or target. - `pricingConfiguration` object — Allows for pricing configurations to be overridden by partners on a transfer level. - `fee` object - `type` string — Identifies the type of fee that will be configured. Options include only `OVERRIDE`. - `variable` number — The selected variable percentage (in decimal format) that should be used in the pricingConfiguration. - `fixed` number — The selected fixed fee (in source currency) that should be used in the pricingConfiguration. - `paymentOptions` object[] — List of the methods a user can pay for the transfer. - `disabled` boolean — Whether this option is enabled or not for this quote. - `estimatedDelivery` string, date-time — The estimated delivery time for this combination of payIn and payOut methods, assuming payIn is performed now. - `formattedEstimatedDelivery` string — A string to display to users for the estimated delivery date. - `estimatedDeliveryDelays` object[] — Array of objects for delivery delays to display to users. - `reason` string — Reason of the delivery delay. - `fee` object — Object containing fee information. - `transferwise` number — The fee to be paid by the sender based on the current state of the quote. - `payIn` number — The fee for this payment option, based on the product type of the payment option. - `discount` number — Any discounts that have been applied to this quote for the user. - `partner` number — If you have agreed a custom price, it will be displayed here. - `total` number — The total fees to be paid - use this figure when displaying fees on your app. - `price` object — Object containing the price information. - `priceSetId` integer — ID of the price structure. - `total` object — The total fees to be paid - use this figure when displaying fees on your app. - `type` string — Type of the pricing element. - `label` string — Short text describing the price structure. - `value` object — Object containing value elements. - `amount` number — Amount to be paid. - `currency` string — Currency of the amount to be paid. - `label` string — Text version of the price. - `explanation` object — Object element giving more details about the price. - `items` object[] — Object containing the details of the different elements of the total price. - `id` string — ID of this item. - `type` string — Type of the pricing item. It could be `DISCOUNT` for example. - `label` string — Short text describing the pricing element. - `value` object — Object containing value elements. - `amount` number — Amount associated to this pricing element. Can be negative for discounts. - `currency` string — Currency of the pricing element. - `label` string — Text field containing the price and its currency. - `explanation` object — Additional information on a price breakdown item. - `plainText` string — Text element giving more details about the item. - `markdown` string — Formatted textual information. - `deferredFee` object — Deferred fee information from a pricingConfiguration override. - `amount` number — The amount of fees that has been deferred by a pricingConfiguration override. - `currency` string — The currency of the deferred fee amount. - `calculatedOn` object - `unroundedAmountToConvert` object — The amount, unrounded, that fees were calculated on and built up from. - `amount` number - `currency` string - `sourceAmount` number — sourceAmount when using this payment option. - `targetAmount` number — targetAmount when using this payment option. - `sourceCurrency` string — Source currency for this payment option. - `targetCurrency` string — Target currency for this payment option. - `payIn` string — Type of pay in method for this payment option. - `payOut` string — Type of pay out method for this payment option. - `allowedProfileTypes` string[] — Array of the allowed types of profile to use this payment option. - `payInProduct` string — Pay-in product type. - `feePercentage` number — Fee percentage for this payment option. - `disabledReason` object — Object present if a payment option is disabled. - `code` string — Code to denote the reason a payment method is unavailable. - `message` string — User friendly message to display when a method is unavailable. - `status` 'PENDING' | 'ACCEPTED' | 'FUNDED' | 'EXPIRED' — Current status of this quote. - `expirationTime` string, date-time — The time the quote expires. - `notices` object[] — Array of messages to display to the user. May be empty (`[]`) if there are no messages. - `text` string — The message to display. - `link` string, nullable — URL that provides more information to the message. May be `null` if there's no URL. - `type` 'WARNING' | 'INFO' | 'BLOCKED' — Type of message. If it is `BLOCKED`, don't allow the quote to be used to create the transfer. ## Other responses - `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header. --- [API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/4907a1d269ab/schema)