List All Currencies

Retrieve the currency used by every country, with optional reverse lookup by ISO 4217 code

GET /v1/currency

cURL (all currencies)

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")

200 - Full List (truncated)

[
  {
    "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": 400,
  "message": "Invalid currency code. Must be a 3-letter ISO 4217 code (e.g., USD, EUR).",
  "details": null
}

{
  "error": "This feature is not available on your current plan.",
  "feature": "currencyApi",
  "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: Supporter 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.

Authentication

X-CSCAPI-KEY · string · required

Your API key for authentication

Query Parameters

code · string

Optional ISO 4217 currency code (3 letters, case-insensitive). When set, returns only countries that use that currency. Invalid codes return 400.

Response

Returns an array of objects with this shape:

country · string

ISO2 code of the country (e.g., "US", "IN", "FR")

currency · object

Currency information

Show properties

code · string

ISO 4217 currency code (e.g., "USD", "EUR"). Always present.

name · string | null

Full currency name (e.g., "United States dollar"). May be null for edge-case territories.

symbol · string | null

Unicode currency symbol (e.g., "$", "€", "₹"). May be null — clients should fall back to code when rendering.

cURL (all currencies)

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")

200 - Full List (truncated)

[
  {
    "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": 400,
  "message": "Invalid currency code. Must be a 3-letter ISO 4217 code (e.g., USD, EUR).",
  "details": null
}

{
  "error": "This feature is not available on your current plan.",
  "feature": "currencyApi",
  "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)