---
title: "List Hubs"
method: GET
path: "/v1/hubs"
tags: ["Hubs"]
---

# List Hubs

`GET /v1/hubs`

## 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/hubs`
- Auth: API key in header `X-API-Key`

List your host's hubs: the events that carry a community agenda.

Use this to find the `hubSlug` the other hub endpoints take. Most recent
first, so the hub a host is actually curating is on the first page.
Page past `limit` with `offset` when `hasMore` is true.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- ApiResponseExternalHubList
  - `data` ExternalHubList, required: The host's hubs, capped by ``limit``.
    - `hubs` ExternalHub[], required
      - `slug` string, required
      - `title` string, required
      - `eventType` string, required: Either "hub" (a multi-day series container) or "event".
      - `status` string, nullable
      - `isPublic` boolean: False for a private hub. Private and unlisted hubs are kept out of discovery and search, but their schedule is still readable by anyone holding the hub's link.
      - `unlisted` boolean: True for a link-only hub, kept out of discovery and search.
      - `image` string, nullable
      - `startDate` string, required
      - `endDate` string, nullable
      - `timezone` string
      - `agendaEventCount` integer: Events currently on the agenda and publicly visible. A child that was added and has since been unpublished or made private is on the agenda but not counted here, because it is not showing on the hub page either.
      - `pendingSubmissionCount` integer: Community submissions awaiting the hub host's review. Reviewing them is a dashboard action; this count is informational here.
    - `total` integer, required: Total hubs on the host, which may exceed the number returned. Page through them with `offset` while `hasMore` is true.
    - `hasMore` boolean: True when hubs remain past this page. Request the next page with `offset` raised by `limit`.
  - `success` boolean
  - `message` string, nullable

## 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)