Skip to main content
GET
/
v1
/
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": "$"
  }
}

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 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
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": "$"
  }
}