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

# List Events

`GET /v1/events`

## Request

- Base URL: `https://developer.eventship.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.eventship.com/v1/events`
- Auth: API key in header `X-API-Key`

List events for your host.

Returns summary data for each event (title, dates, location,
capacity). Use GET /v1/events/{event_slug} for full details including
sessions, speakers, and ticket types — and, for hub events that accept
community submissions, pass `includeCommunityEvents=true` there to also
get the approved community-submitted schedule (`communityEvents`).

## Query parameters

- `status` string, nullable: Filter by event status (draft, live, cancelled)
- `after` string, date, nullable: Only events starting on or after this date (YYYY-MM-DD)
- `before` string, date, nullable: Only events starting on or before this date (YYYY-MM-DD)
- `page` integer
- `pageSize` integer

## Response `200`

Successful Response

- PaginatedResponseExternalEventSummary
  - `data` ExternalEventSummary[], required
    - `slug` string, required
    - `title` string, required
    - `description` string
    - `status` string, nullable
    - `image` string, nullable
    - `startDate` string, required
    - `endDate` string, nullable
    - `timezone` string
    - `venue` string
    - `address` string
    - `locationType` string
    - `virtualLink` string, nullable
    - `externalRegistrationUrl` string, nullable
    - `cityName` string, nullable
    - `stateName` string, nullable
    - `registeredCount` integer
    - `ticketsLeft` integer, nullable
    - `isSoldOut` boolean, nullable
    - `currency` string: ISO 4217 code every price on this event is denominated in, including its ticket types. A client cannot assume USD, and cannot infer this from the host either: an imported event takes the currency the source page stated, an event created without one takes the host's Stripe settlement currency, and a currency Eventship cannot sell in (whether the source's or the host's) is substituted. A substitution keeps the numeric prices and changes the unit under them, so read this field rather than assuming. The create and import responses additionally name the replaced currency in `message`; the read endpoints have no such field and report only the resolved value here.
  - `total` integer, required
  - `page` integer, required
  - `pageSize` integer
  - `hasMore` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/eventship/apis/eventship-api.md) · [All operations](https://skmtc.dev/eventship/apis/eventship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/eventship/apis/eventship-api/revisions/4b7e010cb94f?raw)