The Poll for a Response operation allows you to check the status of a previously submitted RFQ (Request for Quote). By polling the service, you can retrieve the outcome of the RFQ, such as whether a quote has been issued or if additional action is required.

Example Request:

To poll for a response, send a GET request to the /fx/v1.0/quotes/{quoteIdentifier} endpoint, where {quoteIdentifier} is the unique identifier received when the RFQ was submitted.

Example Response:

On success, the service will return the current status of the quote.

{
  "channelTransactionIdentifier": "0123456789",
  "quoteIdentifier": "MKT-d75a03b5-2d7c-4db0-b30f-bcccc67a4fed",
  "currencyPair": "AUD/USD",
  "swapPoints": "1.3",
  "quoteExpiry": "2019-12-31T11:59:59Z",
  "status": "COMPLETED"
}

Usage Notes:

  • Tracking: Use the quoteIdentifier from the response to keep track of the status of the quote. Poll the endpoint periodically until the quote status is confirmed as complete or reaches another final state.

  • Error Handling: Handle common HTTP errors effectively:

    • 400 Bad Request: Indicates issues with the request format, such as invalid identifiers or missing required parameters.
    • 401 Unauthorised: Occurs when authentication fails, typically due to missing or invalid tokens.
    • 404 Not Found: The specified quote is not available, either due to a wrong identifier or premature polling.