curl -X GET 'https://api.countrystatecity.in/v1/iso/country?iso2=US' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/iso/country?iso3=IND' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/iso/country?numeric=840' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

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

const country = await response.json();
console.log(`${country.name} (id ${country.id})`);

import requests

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

country = response.json()
print(f"{country['name']} → numeric {country['numeric_code']}")

{
  "id": 233,
  "name": "United States",
  "iso2": "US",
  "iso3": "USA",
  "numeric_code": "840"
}

{
  "status": "error",
  "message": "Invalid query parameters: Provide exactly one of: iso2, iso3, numeric"
}

{
  "status": "error",
  "message": "Invalid query parameters: iso2: must be a 2-letter code"
}

{
  "status": "error",
  "message": "This feature is not available on your current plan.",
  "details": {
    "feature": "isoLookup",
    "currentTier": "community",
    "requiredTier": "starter",
    "upgradeUrl": "https://app.countrystatecity.in/pricing"
  }
}

{
  "status": "error",
  "message": "Country not found for the given code"
}