Skip to main content
GET
/
v1
/
currency
curl -X GET 'https://api.countrystatecity.in/v1/currency' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

[
  {
    "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": "؋" }
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.countrystatecity.in/llms.txt

Use this file to discover all available pages before exploring further.

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
curl -X GET 'https://api.countrystatecity.in/v1/currency' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

[
  {
    "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": "؋" }
  }
]