Response attributes
Name
Type
Description
name.short
String
Short currency name (i.e. dollar)
name.full
String
Full currency name (i.e. United States dollar)
code
String
ISO 4217 currency code
symbol
String
Currency symbol (notice: use UTF-8 to properly display all the symbols)
subunit.name
String
Singular noun of the currency subunit
subunit.ratio
int
Defines how many subunits are in the one (base) unit
denominations.type
String
COIN or BANKNOTE
denominations.value
int
Value in subunits
denominations.displayAs
String
How the actual value is presented on the coin/banknote. Notice that sometimes coins would read 1/2 of the base currency instead of 50 subunits, if the subunit.ratio is 100 (ex. Algerian dinar has a values of 1/4 or 1/2 dinars)
denominations.isSubunit
String
Whether displayAs value is in subunits or not
Response text attributes
Basic Startup Business
Name
Type
Description
textual.title
String
Currency category name
textual.sections.id[SUMMARY].body
String
Country currency, symbol and code
textual.sections.id[DENOMINATIONS].body
String
Denominations (banknotes & coins)
Example response
{
"name": {
"short": "euro",
"full": "euro"
},
"code": "EUR",
"symbol": "€",
"subunit": {
"name": "Cent",
"ratio": 100
},
"denominations": [
{
"type": "BANKNOTE",
"value": 5000,
"displayAs": "50",
"isSubunit": false
},
{
"type": "COIN",
"value": 10,
"displayAs": "10",
"isSubunit": true
},
{
"type": "BANKNOTE",
"value": 10000,
"displayAs": "100",
"isSubunit": false
},
{
"type": "BANKNOTE",
"value": 1000,
"displayAs": "10",
"isSubunit": false
},
{
"type": "COIN",
"value": 1,
"displayAs": "1",
"isSubunit": true
},
{
"type": "BANKNOTE",
"value": 2000,
"displayAs": "20",
"isSubunit": false
},
{
"type": "COIN",
"value": 20,
"displayAs": "20",
"isSubunit": true
},
{
"type": "COIN",
"value": 50,
"displayAs": "50",
"isSubunit": true
},
{
"type": "BANKNOTE",
"value": 500,
"displayAs": "5",
"isSubunit": false
},
{
"type": "COIN",
"value": 200,
"displayAs": "2",
"isSubunit": false
},
{
"type": "COIN",
"value": 2,
"displayAs": "2",
"isSubunit": true
},
{
"type": "COIN",
"value": 5,
"displayAs": "5",
"isSubunit": true
},
{
"type": "COIN",
"value": 100,
"displayAs": "1",
"isSubunit": false
},
{
"type": "BANKNOTE",
"value": 20000,
"displayAs": "200",
"isSubunit": false
},
{
"type": "BANKNOTE",
"value": 50000,
"displayAs": "500",
"isSubunit": false
}
],
"textual": {
"title": "Currency",
"sections": [
{
"id": "SUMMARY",
"body": [
"France uses the euro (symbol: €), code EUR."
]
},
{
"id": "DENOMINATIONS",
"body": [
"Banknotes come in denominations of 500, 200, 100, 50, 20, 10 and 5 euros. Euro is subdivided into 100 cents. Coins come in denominations of 2 and 1 euro and 50, 20, 10, 5, 2 and 1 cent."
]
}
]
}
}