The Open Exchange Rates API will return JSON error messages if something goes wrong, to help you debug your applications and raise alerts.

All Open Exchange Rates API errors currently use the same format.

Here's an example, produced when an invalid app_id is provided:

{
  "error": true,
  "status": 401,
  "message": "invalid_app_id",
  "description": "Invalid App ID provided - please sign up at https://openexchangerates.org/signup, or contact [email protected]."
}

Error Status Codes Reference

There are several potential errors, the most common listed below:

MessageStatus CodeDetails
"not_found"404Client requested a non-existent resource/route
"missing_app_id"401Client did not provide an App ID
"invalid_app_id"401Client provided an invalid App ID
"not_allowed"429Client doesn’t have permission to access requested route/feature
"access_restricted"403Access restricted for repeated over-use (status: 429), or other reason given in ‘description’ (403).
"invalid_base"400Client requested rates for an unsupported base currency

📘

If you get an error that is not documented here, or experience some other issue with the API, please contact us.