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

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

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

const params = new URLSearchParams({ from: 'iso2', to: 'iso3', value: 'DE' });
const response = await fetch(
  `https://api.countrystatecity.in/v1/iso/country/convert?${params}`,
  { headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' } }
);

const { result } = await response.json();
console.log(result); // "DEU"

import requests

response = requests.get(
  'https://api.countrystatecity.in/v1/iso/country/convert',
  params={'from': 'iso2', 'to': 'numeric', 'value': 'JP'},
  headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)

print(response.json()['result'])  # "392"

{
  "from": "iso2",
  "to": "iso3",
  "input": "US",
  "result": "USA"
}

{
  "from": "iso3",
  "to": "numeric",
  "input": "IND",
  "result": "356"
}

{
  "status": "error",
  "message": "Invalid query parameters: from and to must be different"
}

{
  "status": "error",
  "message": "Invalid query parameters: value does not match the format required by from"
}

{
  "status": "error",
  "message": "Invalid query parameters: from: must be one of: iso2, iso3, numeric"
}

{
  "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"
}

{
  "status": "error",
  "message": "No iso3 code available for this country"
}