Events

Get Event

Get event details by slug.

Hub events (events that accept community submissions) can also embed their approved community-submitted schedule: pass includeCommunityEvents=true and the response includes a communityEvents array ordered by start time. The field is null unless requested and the event is a hub. Only approved, live, public, listed events appear — the same privacy rules as the hub's public schedule page.

Each community event carries its own description and, when its host takes registrations elsewhere, externalRegistrationUrl — enough to mirror the approved schedule onto your own site without a second call per event. Those events belong to other hosts, so their descriptions are user-authored content from outside your account: sanitize before rendering as HTML.

get/v1/events/{event_slug}

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/{event_slug}
  • Auth: API key in header X-API-Key

Path parameters

event_slugstring required

Query parameters

includeCommunityEventsboolean

Set true to also return the hub's approved community-submitted events as communityEvents (hubs only — events that accept community submissions). Off by default to keep the payload lean.

Response

Successful Response

slugstring required
titlestring required
descriptionstring
statusstring nullable
imagestring nullable
startDatestring required
endDatestring nullable
timezonestring
venuestring
addressstring
locationTypestring
virtualLinkstring nullable
externalRegistrationUrlstring nullable
cityNamestring nullable
stateNamestring nullable
registeredCountinteger
ticketsLeftinteger nullable
isSoldOutboolean nullable
currencystring

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.

hostSlugstring nullable
stripeReadyboolean

Whether the host has completed Stripe onboarding (needed for paid tickets).

Changes

No recorded changes to this operation across all 1 revision of this API.