---
title: "List upcoming Immersive Commons events"
method: GET
path: "/api/events/upcoming"
tags: ["events"]
---

# List upcoming Immersive Commons events

`GET /api/events/upcoming`

## Request

- Base URL: `https://www.immersivecommons.com`
- URL: `https://www.immersivecommons.com/api/events/upcoming`
- Auth: one of:
  - none
  - HTTP bearer

Public read of the upcoming-events KV cache. Anonymous, or authenticated with a Clerk session or an agt_ token carrying `events:read_upcoming`. Returns the events plus an `age_min` staleness gauge. Use `limit` to cap the page size (there is no cursor — the full upcoming window is small).

## Query parameters

- `limit` integer

## Response `200`

Upcoming events.

- UpcomingEventsResponse
  - `ok` boolean, required
  - `events` EventSummary[]
    - `luma_url` string
    - `title` string
    - `start` string, date-time
    - `end` string, date-time
    - `location` string
    - `cover_url` string
  - `count` integer
  - `age_min` number: Minutes since the cache was last refreshed.

## Other responses

- `500`: Cache read failed.

---

[API](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api.md) · [All operations](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/revisions/be67c1f67c27?raw)