Skip to main content
GET
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.

Authorizations

X-CSCAPI-KEY
string
header
required

API key for authentication. Get your free key at app.countrystatecity.in.

Query Parameters

code
string

ISO 4217 currency code to filter by (e.g., EUR). Returns all countries using this currency.

Required string length: 3
Example:

"EUR"

Response

List of currency entries ordered by country ISO2 code

country
string
required

ISO 3166-1 alpha-2 country code

Example:

"IN"

currency
object
required