
About REST Countries
REST Countries is a data API that returns normalised information about countries and territories. Each record includes names, codes, capitals, currencies, languages, borders and many other fields.
What it does
You request a country by code or name and receive a JSON record with the fields you need. Responses can be trimmed with a response fields parameter, so you only get the values your app uses. The data covers political leaders, population, geography, time zones, calling codes and flags, with links to SVG and PNG images. Records are updated from several sources on a regular schedule. Requests use a bearer token, and a demo key appears on the site for trying the API.
Key features
- Look up country names, codes, capitals and flags
- Get currencies, languages, borders and calling codes
- Choose the fields you need with a parameter
- Get leaders, population and demographic data
- Authenticate each request with a bearer token
Who it's for
Developers and data teams who build forms, dashboards or travel apps that need country information will find it useful. Teams that need consistent country codes across several systems can also use it as a reference source.
Pricing and good to know
An API key is needed for regular use, and the docs describe how to get one. Check the site's terms for usage limits before you plan a large project. Data from several sources can contain gaps or delays, so validate critical values before relying on them.
Highlights
- Look up country names, codes, capitals and flags
- Get currencies, languages, borders and calling codes
- Choose the fields you need with a parameter
- Get leaders, population and demographic data
- Authenticate each request with a bearer token












