API reference

Every screen in the mobile app and the portal is backed by a public endpoint under /api/v1/.... The interactive Redoc reference below is generated from the same OpenAPI specification the apps build against.

Conventions

• Base URL — https://<tenant_id>.festinato.app/api/v1. The first label of the host selects your tenant. With a custom domain configured, the same endpoints answer on your hostname.
• Content types — JSON for everything except image endpoints (*/cover, */logo), which return image/png.
• Authentication — catalogue endpoints (artists, venues, slots, news, info, sponsors, weather, festivals) are public. Bookmark and push endpoints carry an opaque user_token / device token in the URL or body rather than a session cookie.
• Versioning — every path is prefixed with /api/v1/. We bump to /api/v2/ if any response shape changes incompatibly.

Interactive reference