curl -X GET 'https://api.countrystatecity.in/v1/currency' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
curl -X GET 'https://api.countrystatecity.in/v1/currency?code=EUR' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
const response = await fetch('https://api.countrystatecity.in/v1/currency?code=EUR', {
headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});
const eurozone = await response.json();
console.log(`${eurozone.length} countries use EUR`);
import requests
response = requests.get(
'https://api.countrystatecity.in/v1/currency',
params={'code': 'EUR'},
headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)
eurozone = response.json()
print(f"{len(eurozone)} countries use EUR")
[
{
"country": "AD",
"currency": { "code": "EUR", "name": "Euro", "symbol": "€" }
},
{
"country": "AE",
"currency": { "code": "AED", "name": "United Arab Emirates dirham", "symbol": "د.إ" }
},
{
"country": "AF",
"currency": { "code": "AFN", "name": "Afghan afghani", "symbol": "؋" }
}
]
[
{ "country": "AD", "currency": { "code": "EUR", "name": "Euro", "symbol": "€" } },
{ "country": "AT", "currency": { "code": "EUR", "name": "Euro", "symbol": "€" } },
{ "country": "BE", "currency": { "code": "EUR", "name": "Euro", "symbol": "€" } },
{ "country": "DE", "currency": { "code": "EUR", "name": "Euro", "symbol": "€" } },
{ "country": "FR", "currency": { "code": "EUR", "name": "Euro", "symbol": "€" } }
]
{
"status": "error",
"message": "Invalid currency code. Must be a 3-letter ISO 4217 code (e.g., USD, EUR)."
}
{
"status": "error",
"message": "This feature is not available on your current plan.",
"details": {
"feature": "currencyApi",
"currentTier": "community",
"requiredTier": "starter",
"upgradeUrl": "https://app.countrystatecity.in/pricing"
}
}
Currencies
List All Currencies
Retrieve the currency used by every country, with optional reverse lookup by ISO 4217 code
GET
/
currency
curl -X GET 'https://api.countrystatecity.in/v1/currency' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
curl -X GET 'https://api.countrystatecity.in/v1/currency?code=EUR' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
const response = await fetch('https://api.countrystatecity.in/v1/currency?code=EUR', {
headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});
const eurozone = await response.json();
console.log(`${eurozone.length} countries use EUR`);
import requests
response = requests.get(
'https://api.countrystatecity.in/v1/currency',
params={'code': 'EUR'},
headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)
eurozone = response.json()
print(f"{len(eurozone)} countries use EUR")
[
{
"country": "AD",
"currency": { "code": "EUR", "name": "Euro", "symbol": "€" }
},
{
"country": "AE",
"currency": { "code": "AED", "name": "United Arab Emirates dirham", "symbol": "د.إ" }
},
{
"country": "AF",
"currency": { "code": "AFN", "name": "Afghan afghani", "symbol": "؋" }
}
]
[
{ "country": "AD", "currency": { "code": "EUR", "name": "Euro", "symbol": "€" } },
{ "country": "AT", "currency": { "code": "EUR", "name": "Euro", "symbol": "€" } },
{ "country": "BE", "currency": { "code": "EUR", "name": "Euro", "symbol": "€" } },
{ "country": "DE", "currency": { "code": "EUR", "name": "Euro", "symbol": "€" } },
{ "country": "FR", "currency": { "code": "EUR", "name": "Euro", "symbol": "€" } }
]
{
"status": "error",
"message": "Invalid currency code. Must be a 3-letter ISO 4217 code (e.g., USD, EUR)."
}
{
"status": "error",
"message": "This feature is not available on your current plan.",
"details": {
"feature": "currencyApi",
"currentTier": "community",
"requiredTier": "starter",
"upgradeUrl": "https://app.countrystatecity.in/pricing"
}
}
Retrieve the currency mapping for every country in the database. Each item links a country (by ISO2) to its currency
code, name, and symbol. Use the optional ?code= query parameter to perform a reverse lookup and find every country that uses a given ISO 4217 currency code (e.g., all Eurozone countries).
Availability: Starter plan and above. Returns
403 on lower tiers.The list is alphabetically ordered by country ISO2 and excludes countries without currency data (~0.1% of records). Results are cached server-side for 24 hours.
curl -X GET 'https://api.countrystatecity.in/v1/currency' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
curl -X GET 'https://api.countrystatecity.in/v1/currency?code=EUR' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
const response = await fetch('https://api.countrystatecity.in/v1/currency?code=EUR', {
headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});
const eurozone = await response.json();
console.log(`${eurozone.length} countries use EUR`);
import requests
response = requests.get(
'https://api.countrystatecity.in/v1/currency',
params={'code': 'EUR'},
headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)
eurozone = response.json()
print(f"{len(eurozone)} countries use EUR")
[
{
"country": "AD",
"currency": { "code": "EUR", "name": "Euro", "symbol": "€" }
},
{
"country": "AE",
"currency": { "code": "AED", "name": "United Arab Emirates dirham", "symbol": "د.إ" }
},
{
"country": "AF",
"currency": { "code": "AFN", "name": "Afghan afghani", "symbol": "؋" }
}
]
[
{ "country": "AD", "currency": { "code": "EUR", "name": "Euro", "symbol": "€" } },
{ "country": "AT", "currency": { "code": "EUR", "name": "Euro", "symbol": "€" } },
{ "country": "BE", "currency": { "code": "EUR", "name": "Euro", "symbol": "€" } },
{ "country": "DE", "currency": { "code": "EUR", "name": "Euro", "symbol": "€" } },
{ "country": "FR", "currency": { "code": "EUR", "name": "Euro", "symbol": "€" } }
]
{
"status": "error",
"message": "Invalid currency code. Must be a 3-letter ISO 4217 code (e.g., USD, EUR)."
}
{
"status": "error",
"message": "This feature is not available on your current plan.",
"details": {
"feature": "currencyApi",
"currentTier": "community",
"requiredTier": "starter",
"upgradeUrl": "https://app.countrystatecity.in/pricing"
}
}
Related Endpoints
- Get Currency by Country — fetch the currency for a single country
- Get Country Details — full country record (includes currency fields inline)
Authorizations
API key for authentication. Get your free key at app.countrystatecity.in.
Query Parameters
ISO 4217 currency code to filter by (e.g., EUR). Returns all countries using this currency.
Required string length:
3Example:
"EUR"