Countries API
Countries with ISO codes, capitals, regions, currencies, languages and timezones. Hardcoded in-memory data: writes last until the app restarts.
Your account unlocks these endpoints. Try it on each endpoint's page sends your key for you; from your own code, send a key from your API keys page in the X-TestingApis-Key header.
These endpoints need a free account. Create one or sign in to see their details and try them here.
- GET
https://api.testingapis.com/api/CountriesList countries with filtering, sorting, search and paginationList countries with filtering, sorting, search and pagination. - POST
https://api.testingapis.com/api/CountriesCreate a countryCreate a country. - GETHEAD
https://api.testingapis.com/api/Countries/{id}Get a country by IDGet a country by ID (HEAD returns the headers only). - PUT
https://api.testingapis.com/api/Countries/{id}Replace a countryReplace a country. - PATCH
https://api.testingapis.com/api/Countries/{id}Partially update a country with a JSON merge patchPartially update a country with a JSON merge patch. - DELETE
https://api.testingapis.com/api/Countries/{id}Delete a countryDelete a country. - POST
https://api.testingapis.com/api/Countries/bulkCreate up to 100 countries in one requestCreate up to 100 countries in one request. - DELETE
https://api.testingapis.com/api/Countries/bulkDelete several countries by IDDelete several countries by ID. - GET
https://api.testingapis.com/api/Countries/code/{code}Get a country by ISO 3166-1 codeGet a country by ISO 3166-1 code. - GET
https://api.testingapis.com/api/Countries/countCount all countriesCount all countries. - GET
https://api.testingapis.com/api/Countries/region/{name}List the countries in a regionList the countries in a region. - GET
https://api.testingapis.com/api/Countries/regionsList regions with country counts and total populationList regions with country counts and total population.
Example request
List countries with filtering, sorting, search and pagination. Full reference and a Send button.
curl -X GET "https://api.testingapis.com/api/Countries?limit=2" \
-H "X-TestingApis-Key: YOUR_API_KEY"[
{
"id": 1,
"name": "United States",
"code": "US",
"code3": "USA",
"capital": "Washington, D.C.",
"region": "Americas",
"population": 331900000,
"area": 9833520,
"currency": {"code": "USD", "name": "United States dollar", "symbol": "$"},
"languages": ["English"],
… (3 more lines)Sign in to see the details
The parameters, request and response examples and the live Try it panel for these endpoints are for signed-in members. Accounts are free and take a few seconds to create.
Filtering, sorting and pagination
The list endpoint accepts limit, page, offset, sort, order and q, and any field name as an exact filter. Totals come back in the X-Total-Count header. Writes are kept in memory until the server restarts, so tests can create, change and delete records freely. Query parameter reference.