Get a country by ISO 3166-1 code

GEThttps://api.testingapis.com/api/Countries/code/{code}Sign in to see this endpoint's URL

Parameters 1

Name	Type	Description
`code`required	path · string	Alpha-2 (JP) or alpha-3 (JPN) code, case-insensitive.

Responses

200: The country.
404: No country with this code does not exist.

Example

Request

curl -X GET "https://api.testingapis.com/api/Countries/code/JP" \
  -H "X-TestingApis-Key: YOUR_API_KEY"

Response200 OK

{
  "id": 18,
  "name": "Japan",
  "code": "JP",
  "code3": "JPN",
  "capital": "Tokyo",
  "region": "Asia",
  "population": 125700000,
  "area": 377930,
  "currency": {"code": "JPY", "name": "Japanese yen", "symbol": "¥"},
  "languages": ["Japanese"],
  "callingCode": "+81",
  "flag": "🇯🇵",
  "timezones": ["UTC+09:00"]
… (1 more lines)

The parameters, request and response examples and the live Try it panel for this endpoint are for signed-in members. Accounts are free and take a few seconds to create.

Try itSign-in requiredUses your key

api.testingapis.com

curl 'https://api.testingapis.com/api/Countries/code/JP' \
  -H 'X-TestingApis-Key: YOUR_API_KEY'

const res = await fetch("https://api.testingapis.com/api/Countries/code/JP", {
  headers: {
    "X-TestingApis-Key": "YOUR_API_KEY",
  },
});
console.log(res.status, await res.text());

const res = await fetch("https://api.testingapis.com/api/Countries/code/JP", {
  headers: {
    "X-TestingApis-Key": "YOUR_API_KEY",
  },
});
const body: string = await res.text();
console.log(res.status, body);

import requests

res = requests.get(
    "https://api.testingapis.com/api/Countries/code/JP",
    headers={
        "X-TestingApis-Key": "YOUR_API_KEY",
    },
)
print(res.status_code, res.text)

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://api.testingapis.com/api/Countries/code/JP");
request.Headers.TryAddWithoutValidation("X-TestingApis-Key", "YOUR_API_KEY");
using var response = await client.SendAsync(request);
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");

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

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.testingapis.com/api/Countries/code/JP"))
                .header("X-TestingApis-Key", "YOUR_API_KEY")
                .GET()
                .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}

package main

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

func main() {
	req, err := http.NewRequest("GET", "https://api.testingapis.com/api/Countries/code/JP", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-TestingApis-Key", "YOUR_API_KEY")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(res.StatusCode, string(data))
}

GEThttps://api.testingapis.com/api/Countries/code/JP

Path

coderequiredstring