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:

Message

Status Code

Details

"not_found"

404

Client requested a non-existent resource/route

"missing_app_id"

401

Client did not provide an App ID

"invalid_app_id"

401

Client provided an invalid App ID

"not_allowed"

429

Client doesn’t have permission to access requested route/feature

"access_restricted"

403

Access restricted for repeated over-use (status: 429), or other reason given in ‘description’ (403).

"invalid_base"

400

Client 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.