Get Currency by Country - Country State City Documentation

curl -X GET 'https://api.countrystatecity.in/v1/currency/US' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

{
  "country": "US",
  "currency": {
    "code": "USD",
    "name": "United States dollar",
    "symbol": "$"
  }
}

GET

currency

{ciso}

curl -X GET 'https://api.countrystatecity.in/v1/currency/US' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

{
  "country": "US",
  "currency": {
    "code": "USD",
    "name": "United States dollar",
    "symbol": "$"
  }
}

Retrieve the currency used by a single country. The path parameter accepts three forms for flexibility:

Availability: Supporter plan and above. Returns 403 on lower tiers.

Responses are cached server-side for 24 hours. Equivalent identifier forms (e.g., 1 and 001) resolve to the same cache slot.

Authentication

X-CSCAPI-KEY

string

required

Your API key for authentication

ciso

string

required

ISO2 code, ISO3 code, or numeric country ID. Case-insensitive for ISO codes.

country

string

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

currency

object

Currency information

Show properties

code

string

ISO 4217 currency code (e.g., "USD"). Always present — endpoint returns 404 if the country has no currency on record.

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 — fall back to code when rendering.

curl -X GET 'https://api.countrystatecity.in/v1/currency/US' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

{
  "country": "US",
  "currency": {
    "code": "USD",
    "name": "United States dollar",
    "symbol": "$"
  }
}

List All Currencies — every country’s currency in one call, with optional reverse lookup
Get Country Details — full country record including currency fields inline