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 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:

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?
Yes. If you choose annual billing, the total price of your subscription plan will be up to 15% lower than the total amount you would pay with a monthly payment frequency.
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.