Private Beta—Found a bug or have feedback? Share it →

Countries

Country data including name, capital, population, area, region, currencies, and languages. Lookup by name or ISO code. Free, no key required.

Healthy

Knowledge & EducationNo upstream key required

Base URL

https://api.apiclearinghouse.com/v1/call/countries

Authenticate with X-Api-Key: chk_live_... header.

GET/name

Name	Type	Required	Description
name	string	required	Country name (e.g. "france", "japan")

curl -s "https://api.apiclearinghouse.com/v1/call/countries/name?name={name}" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "status": "success",
  "data": {
    "results": "example"
  }
}

GET/info

Name	Type	Required	Description
name	string	required	Country name (e.g. "japan", "france")

curl -s "https://api.apiclearinghouse.com/v1/call/countries/info?name={name}" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "status": "success",
  "data": {
    "name": "example",
    "region": "example",
    "capital": "example",
    "population": 51.5
  }
}

GET/code

Name	Type	Required	Description
code	string	required	ISO 3166-1 alpha-2 or alpha-3 country code (e.g. "US", "GBR")

curl -s "https://api.apiclearinghouse.com/v1/call/countries/code?code={code}" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "status": "success",
  "data": {
    "results": "example"
  }
}

No setup required. Sign in and run Countries directly from your browser.

Free10/min

Pro100/min

Elite500/min

Monthly limits also apply per plan.

Pass your API key in the request header:

X-Api-Key: chk_live_...