214 countries and territories189 of 193 UN membersmonthly to 2026-09back to 1926
Documentation / Context / 51 of 75

Convert spend

GET/v1/convert

Converts any money series at the average rate of each period, not one rate for all.

Developer plan and upKey requiredJSON or CSVCached until the next release
Parameters
NameTypeDescription
idrequiredstring
path
Series id from /v1/series
e.g. jp.arrivals.total.m
currencyoptionalstring
query
Convert money to this ISO 4217 currency at each period's rate
e.g. USD
fromoptionalperiod
query
First period to return
e.g. 2025-01
tooptionalperiod
query
Last period to return
e.g. 2026-08
Request
# Spend converted at each period's rate
curl "https://api.tourismapi.com/v1/convert?id=ie.spend.total.m&currency=USD&from=2025-01&to=2026-08" \
  -H "X-API-Key: $TOURISM_API_KEY"
Ready
Example response
{
    "meta": {
        "request_id": "req_9588524814",
        "data_as_of": "2026-10-20T04:48:19Z",
        "count": 20,
        "series": "sr_918xs3ky",
        "from": "EUR",
        "to": "USD",
        "scale": 1,
        "rate": "average rate of the period"
    },
    "data": [
        {
            "period": "2025-01",
            "value": 102.5,
            "rate": 1.035373
        },
        {
            "period": "2025-02",
            "value": 93.71,
            "rate": 1.04125
        },
        {
            "period": "2025-03",
            "value": 106.99,
            "rate": 1.080681
        }
    ]
}
Response fields
FieldTypeExample
periodstring2025-01
valuenumber102.5
ratenumber1.035373