Currencies

Use this endpoint to retrieve a list of currencies in which the DiVA API can report data.

For more information on currency conversion, see the Response Customization page.

Retrieve currencies

Action: GET
Endpoint: /currencies

Retrieve an array of objects that describe the available currencies. Each object contains data about the currency abbreviation, full name, and symbol (if applicable).

The currency object (response)

Name Type Required? Description Allowable Values
currency string Yes The abbreviated name of the currency unit.
unit_text string Yes The full name of the currency unit.
symbol string No The symbol representing the currency unit.

Sample response body

The following sample shows a representative JSON response for a GET request to the /currencies endpoint.

[
    {
        "currency": "AED",
        "unit_text": "UAE Dirham",
        "symbol": null
    },
...
    {
        "currency": "CAD",
        "unit_text": "Canadian Dollar",
        "symbol": "C$"
    },
    {
        "currency": "CDF",
        "unit_text": "Congolese Franc",
        "symbol": null
    },
    {
        "currency": "CHF",
        "unit_text": "Swiss Franc",
        "symbol": "CHF"
    },
    {
        "currency": "CLP CLF",
        "unit_text": "Chilean Peso Unidades de fomento",
        "symbol": "$"
    },
    {
        "currency": "CNY",
        "unit_text": "Yuan Renminbi",
        "symbol": "¥"
    },
    {
        "currency": "COP COU",
        "unit_text": "Colombian Peso Unidad de Valor Real",
        "symbol": "$"
    },
    {
        "currency": "CRC",
        "unit_text": "Costa Rican Colon",
        "symbol": "₡"
    },
    {
        "currency": "CUP CUC",
        "unit_text": "Cuban Peso Peso Convertible",
        "symbol": "₱"
    },
    {
        "currency": "CVE",
        "unit_text": "Cape Verde Escudo",
        "symbol": null
    },
    {
        "currency": "CZK",
        "unit_text": "Czech Koruna",
        "symbol": "Kč"
    },
    {
        "currency": "DJF",
        "unit_text": "Djibouti Franc",
        "symbol": null
    },
    {
        "currency": "DKK",
        "unit_text": "Danish Krone",
        "symbol": "kr"
    },
    {
        "currency": "DOP",
        "unit_text": "Dominican Peso",
        "symbol": "RD$"
    },
    {
        "currency": "DZD",
        "unit_text": "Algerian Dinar",
        "symbol": null
    },
    {
        "currency": "EEK",
        "unit_text": "Kroon",
        "symbol": null
    },
    {
        "currency": "EGP",
        "unit_text": "Egyptian Pound",
        "symbol": "£"
    },
    {
        "currency": "ERN",
        "unit_text": "Nakfa",
        "symbol": null
    },
    {
        "currency": "ETB",
        "unit_text": "Ethiopian Birr",
        "symbol": null
    },
    {
        "currency": "EUR",
        "unit_text": "Euro",
        "symbol": "€"
    },
    {
        "currency": "FJD",
        "unit_text": "Fiji Dollar",
        "symbol": "$"
    },
    {
        "currency": "FKP",
        "unit_text": "Falkland Islands Pound",
        "symbol": "£"
    },
    {
        "currency": "GBP",
        "unit_text": "Pound Sterling",
        "symbol": "£"
    },
    ...
    {
        "currency": "USD",
        "unit_text": "US Dollar",
        "symbol": "$"
    },
    ...
]