---
title: "List events"
method: GET
path: "/api/v1/events"
tags: ["events"]
---

# List events

`GET /api/v1/events`

## Request

- Base URL: `https://jointhestudentlife.com`
- URL: `https://jointhestudentlife.com/api/v1/events`
- Auth: none required

Halloween parties, Welcome Festivals, semester kickoff parties and orientation weeks, with ticket prices per round, early access, status and the buy link.

## Query parameters

- `city` string
- `type` 'all' | 'halloween' | 'welcome_festival' | 'semester_kickoff' | 'orientation_week'
- `upcoming` boolean
- `limit` integer
- `cursor` string

## Response `200`

Events

- EventList
  - `total` integer
  - `events` Event[]
    - `id` string
    - `type` 'halloween' | 'welcome_festival' | 'semester_kickoff' | 'orientation_week'
    - `name` string
    - `city` string
    - `city_slug` string, nullable
    - `start` string
    - `end` string, nullable
    - `timezone` string, nullable
    - `venue` object, nullable
      - `name` string
      - `address` string, nullable
    - `age_min` integer, nullable
    - `url` string, uri
    - `status` 'upcoming' | 'past'
    - `tickets` object
      - `status` 'on_sale' | 'opens_soon' | 'coming_soon' | 'see_page' | 'ended': opens_soon: published, but sales open at sales_open_at.
      - `options` TicketOption[]
        - `name` string
        - `price` number
        - `currency` string
      - `early_access` object, nullable
      - `buy_url` string, uri
      - `note` string
      - `sales_open_at` string, date-time, nullable: When ticket sales open, for status opens_soon.
    - `waitlist_open` boolean
    - `whatsapp_group` string, nullable
    - `entry_rule` string, nullable
  - `next_cursor` string, nullable: Pass as cursor to get the next page; null on the last page.

## Other responses

- `429`: Rate limited
- `default`: Error

---

[API](https://skmtc.dev/jointhestudentlife/apis/the-student-life-api.md) · [All operations](https://skmtc.dev/jointhestudentlife/apis/the-student-life-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jointhestudentlife/apis/the-student-life-api/revisions/d04925a4902b?raw)