API

A simple JSON API to events on this site.

Endpoints

• /api/events/upcoming – all upcoming events
• /api/events/upcoming-monthly – upcoming events grouped by month
• /api/events/all – all events (past and upcoming)
• /api/events/all-monthly – all events grouped by month

Event Schema

Events are fetched from the Kommunity API and transformed to the following schema:

Regular event

{
  "id": "db55ebf9-f0ec-4707-ad72-b6fa880594ed",
  "slug": "hhs-academy-english-club-make-english-your-superpower-2b6ef7f9",
  "title": "HHS Academy: English Club - Make English your Superpower ⚡",
  "desc": "<p>Hack your fluency. Build confidence. Connect with thinkers, makers, and dreamers in English.</p>",
  "leader": "Dogan Can Bakir",
  "leaderUsername": "dogancanbakir",
  "cal": null,
  "start": "2025-12-28T13:00:00",
  "end": "2025-12-28T14:00:00",
  "youtube": null,
  "ama": false,
  "amaId": "",
  "amaAvatar": "",
  "avatar": "https://media.kommunity.com/avatar/d75e2e0b-b4d8-481d-9470-1a1bf28f9eda_avatar_68cfdb38b97a4.jpeg",
  "approved": true,
  "location": "Online",
  "isCanceled": false,
  "photo": "https://media.kommunity.com/communities/diyarbakir-happy-hacking-space/events/hhs-academy-english-club-make-english-your-superpower-2b6ef7f9/81803/hero-block-desktop-design.jpg"
}

AMA

{
  "id": "db55ebf9-f0ec-4707-ad72-b6fa880594ed",
  "slug": "ama-with-example-person",
  "title": "AMA with Example Person",
  "desc": "<p>An interesting Q&A session with an amazing person.</p>",
  "leader": "Example Person",
  "leaderUsername": "exampleperson",
  "cal": null,
  "start": "2025-12-29T19:00:00",
  "end": "2025-12-29T20:00:00",
  "youtube": "https://youtu.be/example",
  "ama": true,
  "amaId": "some-id",
  "amaAvatar": "https://media.kommunity.com/avatar/example.jpeg",
  "avatar": "https://media.kommunity.com/avatar/example.jpeg",
  "approved": true,
  "location": "Online",
  "isCanceled": false,
  "photo": "https://media.kommunity.com/communities/example/events/example-photo.jpg"
}

Field Guide

Basic Information

• id - Unique event identifier from Kommunity
• slug - URL-friendly identifier for the event page
• title - Event name/title
• desc - Event description (HTML formatted)

Organizer Details

• leader - Name of the event organizer
• leaderUsername - Username/handle of the event organizer
• avatar - Avatar URL of the event organizer
• amaAvatar - Avatar URL for AMA host (if AMA event)

Event Details

• location - Event location (usually "Online" or venue name)
• start - Event start date/time (ISO 8601 format)
• end - Event end date/time (ISO 8601 format)
• photo - Event header photo/highlight image URL

Links & Media

• cal - Google Calendar link (if available)
• youtube - YouTube video URL (for past events with recordings)

Status & Type

• ama - Whether this is an AMA event
• amaId - ID for AMA tracking (if applicable)
• approved - Whether the event is approved to display
• isCanceled - Whether the event has been cancelled