Global Exchange Rates
HomeDocsDeveloper API Portal
HomeDocsDeveloper API Portal
  1. Docs
  • Introduction
  • Authentication
  • Formats
  • Extended rates (Bid\Ask)
  • Rate limiting and quotas
  • Errors
  • Client libraries
  • Currencies
    • /currencies
      GET
  • Exchange Rates
    • /latest
      GET
    • /historical
      GET
  • Providers
    • /providers
      GET
  • Conversion
    • /convert
      GET
  1. Docs

Errors

Successful requests will receive a 200 OK response. In the event of invalid requests, such as incorrect parameters, a 400 Bad Request response will be returned.
The error response will include details about the issue, for example (in JSON format):
{ "message": "error message", "errorCode": 1001 }
Other standard response codes (e.g., 401, 403, 429) will be used when applicable.

Error codes#

The following is a list of common error codes returned with status code 400:
Error codeError description
1001Invalid Provider
1002Invalid Currency
1003Invalid Base Currency
1004Base Currency Not Allowed For Provider
1005Invalid Decimal Places
1006Invalid Date Format
1007Invalid Date
1008Date Too Old
1009Invalid Latest Parameter
1017Missing Amount Parameter
1018Invalid Amount Format
1019Plan Does Not Support Currency Conversion\Historical
1021Invalid Base Currency For Provider
📌
If you receive an undocumented error or experience issues with the API, please contact us!
Modified at 2025-09-09 13:53:53
Previous
Rate limiting and quotas
Next
Client libraries
Built with