Skip to main content
GET
/
api
/
events
/
upcoming
Get all upcoming events with available seat counts
curl --request GET \
  --url https://tandem.hlofiys.xyz/api/events/upcoming
[
  {
    "event_id": 123,
    "name": "<string>",
    "description": "<string>",
    "start_time": "2023-11-07T05:31:56Z",
    "end_time": "2023-11-07T05:31:56Z",
    "max_bookings_per_user": 123,
    "preview_image_url": "<string>",
    "is_visible": true,
    "schedule": [
      {
        "time": "15:00",
        "description": "<string>"
      }
    ],
    "hall_id": 123,
    "available_seats_count": 123
  }
]

Response

Successful response. Returns an array of upcoming events with their available seat counts.

​
event_id
integer<int64>
required
​
name
string
required

Event name

​
description
string
required

Event description

​
start_time
string<date-time>
required

Event start time

​
end_time
string<date-time>
required

Event end time

​
max_bookings_per_user
integer
required

The maximum number of seats a single user can book for this event

​
preview_image_url
string
required

Link to download the event preview image

​
is_visible
boolean
required

Controls whether the event is displayed on the public-facing event list

​
schedule
object[]
required
​
hall_id
integer<int64>
required

Unique hall ID

​
available_seats_count
integer
required

The number of seats currently available for booking for this event