Get Currency by Country

Retrieve the official currency for a single country by ISO2, ISO3, or numeric ID

GET /v1/currency/{ciso}

cURL (ISO2)

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

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

const response = await fetch('https://api.countrystatecity.in/v1/currency/US', {
  headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});

const { currency } = await response.json();
console.log(`${currency.symbol} ${currency.code}`);

import requests

response = requests.get(
  'https://api.countrystatecity.in/v1/currency/US',
  headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)

data = response.json()
print(f"{data['country']} uses {data['currency']['code']}")

200 - Success

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

{
  "country": "CU",
  "currency": {
    "code": "CUP",
    "name": "Cuban peso",
    "symbol": null
  }
}

{
  "error": "This feature is not available on your current plan.",
  "feature": "currencyApi",
  "upgradeUrl": "https://app.countrystatecity.in/pricing"
}

{
  "error": "Country not found."
}

{
  "error": "No currency data available for this country."
}

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

• ISO 3166-1 alpha-2 code (e.g., US, IN)
• ISO 3166-1 alpha-3 code (e.g., USA, IND)
• Numeric country ID (e.g., 233 for the United States in our database)

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

Path Parameters

ciso · string · required

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

Response

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 (ISO2)

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

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

const response = await fetch('https://api.countrystatecity.in/v1/currency/US', {
  headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});

const { currency } = await response.json();
console.log(`${currency.symbol} ${currency.code}`);

import requests

response = requests.get(
  'https://api.countrystatecity.in/v1/currency/US',
  headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)

data = response.json()
print(f"{data['country']} uses {data['currency']['code']}")

200 - Success

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

{
  "country": "CU",
  "currency": {
    "code": "CUP",
    "name": "Cuban peso",
    "symbol": null
  }
}

{
  "error": "This feature is not available on your current plan.",
  "feature": "currencyApi",
  "upgradeUrl": "https://app.countrystatecity.in/pricing"
}

{
  "error": "Country not found."
}

{
  "error": "No currency data available for this country."
}

Related Endpoints

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