# Create FX quote

Lock the FX rate for a specific currency pairing. For Account Payouts customers only.

Endpoint: POST /foreignExchange/quote
Version: 1
Security: basicAuth

## Header parameters:

  - `Accept` (string, required)
    Example: "application/vnd.worldpay.foreignexchange-v1+json"

  - `WP-CorrelationId` (string)
    Optional ID to trace requests, if not provided, it is generated.
    Example: "15cd16b2-7b82-41cb-9b11-21be9dacad88"

## Request fields (application/vnd.worldpay.foreignexchange-v1+json):

  - `entity` (string, required)
    6-digit reference given to you by your Implementation Manager during the onboarding process
    Example: "100001"

  - `intent` (string, required)
    Transaction type (intention) for which rates should be retrieved.
    Enum: "PAYOUT", "FX DEAL", "MULTI-CURRENCY PRICING", "CONSUMER RATES", "PAYOUT LIVE RATE"

  - `sourceCurrency` (string, required)
    The debit currency.
    Example: "USD"

  - `targetCurrency` (string, required)
    The credit currency.
    Example: "EUR"

## Response 200 fields (application/vnd.worldpay.foreignexchange-v1+json):

  - `entity` (string)
    6-digit reference given to you by your Implementation Manager during the onboarding process.
    Example: "100001"

  - `intent` (string)
    Transaction type (intention) for which rates should be retrieved.
    Example: "PAYOUT"

  - `quote` (array)
    A collection of account statement items.

  - `quote.quoteId` (string)
    Unique quote id.
    Example: "Q000000001"

  - `quote.sourceCurrency` (string)
    The debit currency.
    Example: "EUR"

  - `quote.targetCurrency` (string)
    The credit currency.
    Example: "GBP"

  - `quote.rateId` (string)
    Unique rate id.
    Example: "12345678"

  - `quote.rate` (string)
    Rate amount.
    Example: "1.2345"

  - `quote.quoteExpiryTime` (string)
    Quote start time.
    Example: "2025-01-10T12:00:00.000Z"

## Response 400 fields (application/vnd.worldpay.foreignexchange-v1+json):

  - `validationErrors` (array, required)
    Object containing details of validation errors occurred

  - `validationErrors.jsonPath` (string, required)
    Parameter for which the error occurred

  - `validationErrors.errorName` (string, required)
    Unique name of the validation error

  - `validationErrors.message` (string, required)
    Error description message

  - `errorName` (string, required)
    The unique error name

## Response 401 fields (application/vnd.worldpay.foreignexchange-v1+json):

  - `errorName` (string, required)
    The unique error name

  - `message` (string, required)
    Error description message

## Response 403 fields (application/vnd.worldpay.foreignexchange-v1+json):

  - `errorName` (string, required)
    The unique error name

  - `message` (string, required)
    Error description message

## Response 404 fields (application/vnd.worldpay.foreignexchange-v1+json):

  - `errorName` (string, required)
    The unique error name

  - `message` (string, required)
    Error description message

## Response 500 fields (application/vnd.worldpay.foreignexchange-v1+json):

  - `errorName` (string, required)
    The unique error name

  - `message` (string, required)
    Error description message