API reference

The Touristservice API is organised around REST. It accepts JSON request bodies, returns JSON responses and uses standard HTTP status codes.

Base URL

https://uphelsinki.touristservice.online/v1

Authentication

Pass your secret key in the Authorization header. Keys are environment specific and can be rotated at any time from the dashboard.

$ curl https://uphelsinki.touristservice.online/v1/accounts \
    -H "Authorization: Bearer sk_live_•••"

List accounts

GET/v1/accounts

ParameterTypeDescription
limitintegerBetween 1 and 100. Defaults to 20.
starting_afterstringCursor for pagination.
statusstringFilter by active or closed.

Rate limits

Up to 100 requests per second per key. Responses include X-RateLimit-Remaining; exceeding the limit returns 429 with a Retry-After header.