General
What is countrylayer?
The countrylayer service provides common information about countries via a REST API. With this API, users will be able to get detailed information about countries in the world by filtering by name of a country, language, code, currency, the capital city, calling code, region, or regional bloc.
Who runs the API?
The countrylayer API is a product built and maintained by apilayer, a technology company that provides a variety of reliable and essential APIs for developers. apilayer’s APIs are affordable for both startups and larger companies. apilayer GmbH is headquartered in Vienna, Austria.
Data & Sources
How accurate is countrylayer data and where does it come from?
Countrylayer has its own database built based on official data from each country.
Which country data does the API provide?
The API provides various data that can be found in the Documentation section.
Which countries are supported by the API?
Countrylayer supports more than 200 countries, meaning that it also supports the non-officially recognized countries.
API Access & Features
How do I get an API access key?
Every registered user is assigned a personal access key, a unique key that can be used to access and query the exchangeratesapi.io API. If you are logged in, you can find it in your Account Dashboard, in the 3-Step Quickstart Guide, and in all interactive links contained in the API’s Documentation. In your account dashboard you can reset your access key at any given time.
What is an API request?
Pricing is based on the number of monthly API Requests offered for each individual Subscription Plan. Accessing any type of countrylayer data using a valid API Access Key counts as one “API Request”. Unlike most other providers, any API Endpoint or feature requested (including Time-Frame & Country Queries, as well as requesting multiple countries at once) counts as only one API Request.
What happens if I exceed my API request volume?
Users will be automatically notified via e-mail and on their Account Dashboard once at least 75%, 90%, and 100% of their monthly API Request allowance has been reached. After reaching 100% of the allowance, overages fees will apply so we make sure you won’t experience any disruptions and your website/application will keep running smoothly. You can learn more about overages billing here.
What is the API’s uptime?
The countrylayer API’s system status is closely monitored around the clock. Every effort is made to ensure the highest possible level of availability and consistency, and we are proud to have an average uptime rate of nearly 100% (99.9%), calculated based on the past 12 months.
There is a public API status page available at the following URL:
https://status.countrylayer.com/.
Plans, Pricing & Payments
What is the difference between free and paid subscription?
The Free Plan is set out to be a “trial version” without a time limit, offering some very basic API functionalities, such as making 100 monthly searches, the rate limit is 1 per second, and access to all endpoint with limited data received.
Paid Subscription Plans feature significantly higher monthly API Request volumes, SSL encryption, include basic to unlimited and prioritised technical support, and offer access to more endpoints and more data received back based on the subscription plan.
What subscription plan fits my needs?
As soon as you or your application requires more than 100 API Requests per month, you would be well-advised to sign up for one of the paid Subscription Plans, starting at a Startup-friendly USD 9.99 per month or get a 15% discount – if you decide to pay annually.
What payment methods are supported?
Payments can be made via credit card (Visa, MasterCard, Discover, Diner’s Club, American Express). Enterprise and high-volume customers may request annual bank transfer payments to be enabled. You can change your payment method at any given time in the “Payment” section of your account dashboard.
Can I also pay yearly?
How can I change my payment frequency?
In order to change your billing frequency from monthly to yearly or from yearly to monthly, you will be required to downgrade your account back to the Free Plan.
Step 1: Navigate to the Subscription page, click “Downgrade” in the Free Plan section and confirm your downgrade. Downgrades are not effective immediately, your premium subscription will remain active until the end of the current billing period.
Step 2: Once your billing period ends and your account downgrade has become effective, navigate back to the Subscription page and click “Upgrade” in your preferred subscription plan’s section. You will now be asked to choose a new billing frequency.
If you need any assistance changing your billing frequency, please do not hesitate to contact us.
How do I cancel/downgrade?
You can initiate a cancellation or downgrade by selecting a new plan and providing at least one reason for your decision. The customer service team will cancel or downgrade your plan. Downgrades are not effective immediately; your premium subscription will remain active until the end of the current billing period.
How do I change between monthly and yearly billing?
To change your subscription from monthly to yearly billing, submit a request on the Contact Us page on the website following these steps:
Step 1. Sign in to your account
Step 2. Go to Contact Us page
Step 4: Fill out the form and choose the “Sales” category for this request.
Step 3. In the text box, include your specific request, for example, “Change from Monthly to Yearly subscription.”
Platinum Support
What is included in Platinum Support?
Platinum Support includes dedicated account management, priority bug fixes, and access to exclusive support resources. It ensures you receive top-tier assistance for any issues you encounter, helping you maintain and optimize your system performance.
How much does Platinum Support cost?
The cost of Platinum Support varies depending on your subscription plan:
– Standard Plan: $479.88 billed annually
– Professional Plan: $599.88 billed annually
– Professional Plus Plan: $719.88 billed annually
– Enterprise Plan: Custom pricing billed annually
How do I select Platinum Support when purchasing a plan?
When you select a pricing plan, the Platinum Support option is automatically checked. You will see a checkbox next to “Include Platinum Support” with the corresponding annual price. You can uncheck this box if you do not wish to include Platinum Support.
How does Platinum Support appear on my invoice?
When you select Platinum Support, your invoice will display “Selected: [Your Plan] + Platinum Support.” The total amount charged will include the cost of your chosen plan and the annual fee for Platinum Support. For example, if you select the Professional Plan, your invoice will read “$49.99/month + $599.88/year for Platinum Support.”
Can existing customers upgrade to include Platinum Support?
Yes, existing customers can upgrade their plans to include Platinum Support. The option will be automatically checked when viewing available plans, showing the respective annual fee for Platinum Support. You can select or unselect this option as needed.
How is the billing period for Platinum Support handled?
The billing period for Platinum Support is annual. When you purchase Platinum Support, the renewal date will be one year from the purchase date. Your invoice will show the purchase date, renewal date, and the total annual amount for Platinum Support.
Can I opt out of Platinum Support during the purchase process?
Yes, Platinum Support is an optional service, you can uncheck the Platinum Support box during the purchase process if you prefer not to include it.
Can I switch back to standard support after upgrading to Platinum Support?
Yes, you can switch back to standard support at any time. However, the change will take effect at the start of your next billing cycle. Contact our support team to adjust your plan.