Get FX quote response

After initialising an FX quote request, we need to get the response ID for the request.

Use case

We will get the FX quote response ID for a request we created with sample data.

Use case data	API parameters with values
The first path parameter is the technical ID of the account to which the payment is being made.	".../ID-1026/fx-quotes/..."
The second path parameter is the FX quote request ID that we got from initialising the request.	".../ID-1263"

Sample API call

To get the FX response ID, use the following endpoint:

https://payment-api.sandbox.tuumplatform.com/api/v1/accounts/ID-1026/fx-quotes/ID-1263

Learn more about the endpoint details from the developer portal.

Sample response

Below you will find the response to the sample request:

Response

{
  "errors": null,
  "validationErrors": null,
  "data": {
    "quoteRequestId": "ID-1263",
    "accountId": "ID-1026",
    "accountNumber": {
      "value": "DK9189000099106120",
      "type": "IBAN"
    },
    "accountServiceProviderCode": "BC",
    "currencyPair": "EURUSD",
    "sellCurrencyCode": "EUR",
    "buyCurrencyCode": "USD",
    "money": {
      "amount": 30,
      "currencyCode": "EUR"
    },
    "tenor": "TODAY",
    "comment": null,
    "source": null,
    "statusCode": "READY",
    "errorCode": null,
    "quoteDtime": "2023-07-20T10:32:15.18642Z",
    "tradeDate": "2025-05-08",
    "settlementDate": "2025-05-08",
    "quoteResponses": [
      {
        "quoteRequestId": "ID-1263",
        "quoteResponseId": "ID-1217",
        "buyMoney": {
          "amount": 34.76,
          "currencyCode": "USD"
        },
        "sellMoney": {
          "amount": 30,
          "currencyCode": "EUR"
        },
        "marginMoney": {
          "amount": 0.35,
          "currencyCode": "USD"
        },
        "feeMoney": null,
        "quoteProviderResponseId": "ID-1217",
        "exchangeRate": 1.158594,
        "fixedSide": "SELL"
      }
    ],
    "requestReason": "FX"
  }
}

Result

We get the FX quote response ID along with other details. Next, we will confirm the quote which creates the FX order. To confirm the request, the status code must be READY.