161 countries and territories138 of 193 UN membersmonthly to 2026-09back to 1926
Documentation / Money and fuel / 76 of 107

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=jp.arrivals.total.m&currency=USD&from=2025-01&to=2026-08" \
  -H "X-API-Key: $TOURISM_API_KEY"
Ready
Example response
{
    "meta": {
        "request_id": "req_7f3a1c",
        "data_as_of": "2026-10-12T12:01:11Z",
        "count": 1,
        "next": null
    },
    "data": [
        {
            "period": "2026-08",
            "value": 89828,
            "converted": 94.3,
            "rate": 952.6
        }
    ]
}
Response fields
FieldTypeExample
periodstring2026-08
valuenumber89828
convertednumber94.3
ratenumber952.6