Get All Countries

Retrieve a complete list of all countries with basic information

GET /v1/countries

cURL

curl -X GET 'https://api.countrystatecity.in/v1/countries' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/countries?q=india' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

import requests

response = requests.get(
  'https://api.countrystatecity.in/v1/countries',
  headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)

countries = response.json()
print(countries)

const response = await fetch('https://api.countrystatecity.in/v1/countries', {
  headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});

const countries = await response.json();
console.log(countries);

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.countrystatecity.in/v1/countries',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => array(
    'X-CSCAPI-KEY: YOUR_API_KEY'
  ),
));

$response = curl_exec($curl);
curl_close($curl);

$countries = json_decode($response, true);
echo json_encode($countries, JSON_PRETTY_PRINT);
?>

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://api.countrystatecity.in/v1/countries"
    
    client := &http.Client{}
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Add("X-CSCAPI-KEY", "YOUR_API_KEY")
    
    res, _ := client.Do(req)
    defer res.Body.Close()
    
    body, _ := ioutil.ReadAll(res.Body)
    fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Countries {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.countrystatecity.in/v1/countries"))
            .header("X-CSCAPI-KEY", "YOUR_API_KEY")
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'json'

uri = URI("https://api.countrystatecity.in/v1/countries")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['X-CSCAPI-KEY'] = 'YOUR_API_KEY'

response = http.request(request)
countries = JSON.parse(response.body)
puts JSON.pretty_generate(countries)

200 - Basic tier (Community, Starter, Legacy)

[
  {
    "id": 101,
    "name": "India",
    "iso2": "IN",
    "iso3": "IND",
    "phonecode": "91",
    "capital": "New Delhi",
    "currency": "INR",
    "native": "भारत",
    "emoji": "🇮🇳",
    "latitude": "20.00000000",
    "longitude": "77.00000000",
    "region": "Asia",
    "region_id": 3,
    "subregion": "Southern Asia",
    "subregion_id": 14,
    "timezones": "[{\"zoneName\":\"Asia/Kolkata\",\"gmtOffset\":19800,\"gmtOffsetName\":\"UTC+05:30\",\"abbreviation\":\"IST\",\"tzName\":\"Indian Standard Time\"}]"
  }
]

[
  {
    "id": 101,
    "name": "India",
    "...": "...all basic fields above...",
    "numeric_code": "356",
    "currency_name": "Indian rupee",
    "currency_symbol": "₹",
    "tld": ".in",
    "nationality": "Indian",
    "population": 1380004385,
    "gdp": 2870504000000,
    "area_sq_km": 3287263,
    "postal_code_format": "######",
    "postal_code_regex": "^(\\d{6})$",
    "emojiU": "U+1F1EE U+1F1F3"
  }
]

[
  {
    "id": 101,
    "name": "India",
    "...": "...all coordinates fields above...",
    "translations": "{\"kr\":\"인도\",\"de\":\"Indien\",\"es\":\"India\",\"fr\":\"Inde\",\"ja\":\"インド\"}",
    "wikiDataId": "Q668"
  }
]

{
  "error": "Unauthorized. You shouldn't be here."
}

Retrieve a complete list of all countries with basic information including ISO codes, phone codes, currencies, and regional data.

Availability: All plans (Community and above). The fields returned vary by tier — see Tier-Based Field Availability below.

Trim and order results: Add ?fields= to limit columns returned, or ?sort= to order the list. Both are available on Supporter+ plans. See the Field Filtering & Sorting guide for syntax and per-entity sortable fields.

Authentication

X-CSCAPI-KEY · string · required

Your API key for authentication

Query Parameters

q · string

Search filter on name. Case-insensitive match on name and native fields. Minimum 2 characters. Requires Supporter+ plan. Without this parameter, all results are returned (no plan restriction for search).

Response

id · integer

Unique identifier for the country

name · string

Official country name in English

iso2 · string

Two-letter ISO 3166-1 alpha-2 country code

iso3 · string

Three-letter ISO 3166-1 alpha-3 country code

phonecode · string

International dialing code for the country

capital · string

Capital city of the country

currency · string

Three-letter ISO 4217 currency code

native · string

Country name in the native language

emoji · string

Flag emoji representation

latitude · string

Country’s approximate latitude

longitude · string

Country’s approximate longitude

region · string

Geographic region name (e.g., Asia, Europe)

region_id · integer

Geographic region ID (foreign key into /regions)

subregion · string

Geographic subregion name (e.g., Southern Asia)

subregion_id · integer

Geographic subregion ID (foreign key into /subregions)

timezones · string

JSON string of timezones (array of {zoneName, gmtOffset, gmtOffsetName, abbreviation, tzName})

Additional fields like numeric_code, currency_name, currency_symbol, tld, nationality, population, gdp, area_sq_km, postal_code_format, postal_code_regex, emojiU, translations, and wikiDataId are returned on higher tiers. See the Tier-Based Field Availability section below.

cURL

curl -X GET 'https://api.countrystatecity.in/v1/countries' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/countries?q=india' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

import requests

response = requests.get(
  'https://api.countrystatecity.in/v1/countries',
  headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)

countries = response.json()
print(countries)

const response = await fetch('https://api.countrystatecity.in/v1/countries', {
  headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});

const countries = await response.json();
console.log(countries);

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.countrystatecity.in/v1/countries',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => array(
    'X-CSCAPI-KEY: YOUR_API_KEY'
  ),
));

$response = curl_exec($curl);
curl_close($curl);

$countries = json_decode($response, true);
echo json_encode($countries, JSON_PRETTY_PRINT);
?>

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://api.countrystatecity.in/v1/countries"
    
    client := &http.Client{}
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Add("X-CSCAPI-KEY", "YOUR_API_KEY")
    
    res, _ := client.Do(req)
    defer res.Body.Close()
    
    body, _ := ioutil.ReadAll(res.Body)
    fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Countries {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.countrystatecity.in/v1/countries"))
            .header("X-CSCAPI-KEY", "YOUR_API_KEY")
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'json'

uri = URI("https://api.countrystatecity.in/v1/countries")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['X-CSCAPI-KEY'] = 'YOUR_API_KEY'

response = http.request(request)
countries = JSON.parse(response.body)
puts JSON.pretty_generate(countries)

200 - Basic tier (Community, Starter, Legacy)

[
  {
    "id": 101,
    "name": "India",
    "iso2": "IN",
    "iso3": "IND",
    "phonecode": "91",
    "capital": "New Delhi",
    "currency": "INR",
    "native": "भारत",
    "emoji": "🇮🇳",
    "latitude": "20.00000000",
    "longitude": "77.00000000",
    "region": "Asia",
    "region_id": 3,
    "subregion": "Southern Asia",
    "subregion_id": 14,
    "timezones": "[{\"zoneName\":\"Asia/Kolkata\",\"gmtOffset\":19800,\"gmtOffsetName\":\"UTC+05:30\",\"abbreviation\":\"IST\",\"tzName\":\"Indian Standard Time\"}]"
  }
]

[
  {
    "id": 101,
    "name": "India",
    "...": "...all basic fields above...",
    "numeric_code": "356",
    "currency_name": "Indian rupee",
    "currency_symbol": "₹",
    "tld": ".in",
    "nationality": "Indian",
    "population": 1380004385,
    "gdp": 2870504000000,
    "area_sq_km": 3287263,
    "postal_code_format": "######",
    "postal_code_regex": "^(\\d{6})$",
    "emojiU": "U+1F1EE U+1F1F3"
  }
]

[
  {
    "id": 101,
    "name": "India",
    "...": "...all coordinates fields above...",
    "translations": "{\"kr\":\"인도\",\"de\":\"Indien\",\"es\":\"India\",\"fr\":\"Inde\",\"ja\":\"インド\"}",
    "wikiDataId": "Q668"
  }
]

{
  "error": "Unauthorized. You shouldn't be here."
}

Tier-Based Field Availability

The fields returned depend on your plan’s data access level.

Tier	Plans	Fields
Basic	Community, Starter, Legacy	id, name, iso2, iso3, phonecode, capital, currency, native, emoji, latitude, longitude, region, region_id, subregion, subregion_id, timezones
Coordinates	Supporter	All Basic + numeric_code, currency_name, currency_symbol, tld, nationality, population, gdp, area_sq_km, postal_code_format, postal_code_regex, emojiU
Full	Professional, Business	All Coordinates + translations, wikiDataId

See Pricing for plan details.

Common Use Cases

Country Selector Dropdown

Use this endpoint to populate country selection dropdowns in forms.

const populateCountryDropdown = async () => {
  const countries = await fetch('/api/countries').then(r => r.json());
  const select = document.getElementById('country-select');
  
  countries.forEach(country => {
    const option = document.createElement('option');
    option.value = country.iso2;
    option.textContent = country.name;
    select.appendChild(option);
  });
};

Currency Context

Get currency information for financial applications.

const getCurrencyInfo = (countries, countryCode) => {
  const country = countries.find(c => c.iso2 === countryCode);
  return {
    code: country.currency,
    symbol: country.emoji
  };
};

Cache country data locally as it rarely changes. This reduces API calls and improves application performance.