Error Codes & Troubleshooting

HTTP error codes for the Foreign Exchange API

This guide explains the most common error responses returned by the FX Hub Partners API endpoints and provides recommended troubleshooting steps.

The FX API uses standard HTTP status codes to indicate whether a request was successful or failed. These responses may occur during quote retrieval, quote acceptance, quote cancellation, trade date retrieval, authentication, or downstream FX processing.

Where applicable, error responses include additional details to help identify the cause of the issue and guide remediation. Common troubleshooting scenarios are outlined below.

---

Common Troubleshooting Scenarios

Error: A position parameter cannot be found that accepts argument xx.crt

How to Resolve: Ensure the private key used to generate the client assertion matches the public key certificate shared with CBA.

---

Error: Failed to open TCP connection to mtls.partner.idp.commbank.com.au:443

How to Resolve: Ensure your network firewall settings allow outbound access to the CBA endpoint.

---

Error: The client id in the request does not match the JWT's sub claim value

{
  "error_description": "The client id ... in the request does not match with the JWT's sub claim value",
  "error": "invalid_request"
}

How to Resolve: Ensure you are using the correct client_id in your token request and that it matches the JWT sub claim value.