Timegem API

REST API for festival timetables, venue data, and events.

Operational

Base URL

All requests are made against the production API host.

ORIGIN https://api.timegem.nl

Quick start

curl https://api.timegem.nl/health

Health

GET /health

Service health check.

Events

GET /api/event/:slugOrId

Fetch a single event by event_slug or UUID.

Venues

GET /api/venue/:slugOrId

Venue details by slug or UUID.

GET /api/venue/:slugOrId/events

All events for a venue, ordered by event_date.

GET /api/venue/:slugOrId/event/:eventSlugOrId

Single event scoped to a venue.

Profiles

GET /api/artists

All festival artists with related artists.

GET /api/spotify-profiles

List available Spotify profiles.

GET /api/spotify-profiles/:profileId

Profile data for a specific ID.

Recommendations

GET /api/artist-recommendations/:profileId

Personalized artist recommendations for a profile.