The Open Exchange Rates API currently supports basic App ID authentication via the
App IDs are 32 hexadecimal (0-9/A-F) characters long, and are unique to each account.
If you have an App ID already, you can enter it into the API Explorer in the API endpoint documentation pages to have it pre-filled and sent with your test requests.
Use the 'Key' icon and enter it next to
Register for an App ID
You can sign up here for your App ID.
If you've already signed up, you can visit your account dashboard at any time to view your App ID.
Using Your App ID
To access any of the API routes, simply append your App ID as a parameter on the end of each request, like so:
curl -v "https://openexchangerates.org/api/latest.json?app_id=YOUR_APP_ID"
Most code samples, extensions, plugins and libraries built for our API have a setting or variable where you can enter your App ID.
HTTP Header Authentication
If you do not wish to specify your App ID in the URL parameters, you may instead provide it as a Token in the HTTP Authorization Header. For example:
"Authorization: Token YOUR_APP_ID"
curl -v -H "Authorization: Token YOUR_APP_ID" "https://openexchangerates.org/api/latest.json"
Please note: The format of the HTTP header must be exactly as above (replacing YOUR_APP_ID with a valid Open Exchange Rates App ID). The App ID should be unquoted. If both HTTP header and URL parameter are provided, we will use the value from the URL and ignore the header.
Tracking App ID Usage
To track the usage of your App ID, you can log in to your account dashboard and visit the Usage Statistics page.
You can also use our usage.json API endpoint to request general usage and quota information about an Open Exchange Rates App ID.
If your account usage goes over the monthly threshold for your plan, we'll email you to discuss options that would best suit your current usage.
Regenerating Your App ID
If you need to create or deactivate an App ID, please visit your Account Dashboard.