Skip to content

Events API

An API key needs the can_view_all_events permission to read events. The list of who is going also needs can_check_in_attendees. Without them you get a 403.

A member token from Sign in with Crewcade can also read events. It needs no extra scope. The member sees what the club pages show that member. The list of who is going stays API key only.

The API lists occurrences. An occurrence is one date of an event.

  • A one-off event has one occurrence. Its id is the event publicId.
  • A recurring event has many dates. Each date has its own id, an 8-character code. All dates share a seriesId, the publicId of the series.

An id never changes. The same date always returns the same id. This holds even after the club edits “this and following” dates.

Drafts never appear. A cancelled date appears with status: "cancelled".

GET /events
QueryTypeMeaning
fromstringStart of the window. An ISO-8601 time with Z or an offset. Default: now.
tostringEnd of the window, same format. Default: 30 days after from. At most 92 days.
seriesIdstringOnly the dates of this recurring event.
pagenumberThe page to read. Starts at 1. Default 1.
pageSizenumberDates per page. From 1 to 100. Default 20.

Dates come back earliest first.

  • For upcoming and live dates, leave from empty.
  • For past dates, set to to now and from to an earlier time.
Terminal window
curl "https://api.crewcade.com/api/v1/events?from=2026-11-01T00:00:00%2B09:00" \
-H "Authorization: Bearer cck_your_key_here"
{
"data": [
{
"id": "k3m9x2pq",
"seriesId": "ab12cd34",
"publicId": "ab12cd34",
"slug": "morning-run",
"urlKey": "morning-run-ab12cd34",
"title": { "en": "Morning run", "ja": "朝ラン" },
"description": { "en": "Easy 5k around the park." },
"start": { "dateTime": "2026-11-12T07:00:00+09:00", "timeZone": "Asia/Tokyo" },
"end": { "dateTime": "2026-11-12T08:00:00+09:00", "timeZone": "Asia/Tokyo" },
"timing": "upcoming",
"status": "scheduled",
"locationType": "in_person",
"venue": { "name": "Yoyogi Park", "address": "2-1 Yoyogikamizonocho, Shibuya" },
"hostName": { "en": "Aki" },
"coverImageUrl": "https://example.com/flyer.jpg",
"capacity": 30,
"spotsRemaining": 12,
"properties": [
{
"propertyId": "prop_123",
"propertyName": { "en": "Club" },
"type": "choice",
"optionIds": ["opt_123"],
"optionNames": [{ "en": "Running" }]
}
]
}
],
"pagination": { "page": 1, "pageSize": 20, "total": 1, "hasNext": false }
}

A window gets a 400 in three cases. It is backwards, it is longer than 92 days, or it has no time zone.

GET /events/{id}

Pass an occurrence id. The reply is one event object, the same shape as an item in data above.

If you pass the publicId of a recurring series, you get a 404 with code: "event_is_series". List its dates with GET /events?seriesId={id}.

GET /events/{id}/registrations

This needs can_view_all_events and can_check_in_attendees. It returns the list your club sees on the event’s attendee page. The list shows confirmed registrations and walk-ins for that one date.

QueryTypeMeaning
pagenumberThe page to read. Starts at 1. Default 1.
pageSizenumberPeople per page. From 1 to 100. Default 20.
{
"data": [
{
"memberId": "mem_123",
"name": { "en": "Alex Kim" },
"email": "[email protected]",
"avatarUrl": null,
"status": "checked_in",
"checkedInAt": "2026-11-12T07:02:11.000Z",
"isWalkIn": false
}
],
"pagination": { "page": 1, "pageSize": 20, "total": 1, "hasNext": false }
}

status is going, checked_in or no_show. memberId is null for a walk-in or a guest who is not a member.

FieldMeaning
idThe occurrence id. Use it for every other call.
seriesIdThe publicId of the recurring series. null for a one-off event.
publicIdThe event publicId. For a recurring date, this is the series.
slugA readable label. It can change.
urlKeyThe slug-publicId key that Crewcade event links use.
titleThe title, by language code.
descriptionThe description, by language code. Can be null.
start, enddateTime with the offset for that date, and the IANA timeZone.
timingupcoming, live or past, worked out when you call.
statusscheduled or cancelled.
locationTypein_person, online, hybrid or none.
venuename and address. Either can be null.
hostNameWho hosts that date, by language code. Can be null.
coverImageUrlThe flyer image. Can be null.
capacitySeats. null means no limit.
spotsRemainingSeats left. null means no limit.
propertiesFields your club defines for events, such as a club or a level.
eventUrlThe address of the event page on Crewcade. The list and one date both have it.
tiersThe tickets of the date. Only on one date. See below.

GET /events/{id} returns tiers. A tier is one kind of ticket.

FieldMeaning
idThe tier id. Send it as tierId when you register a member.
nameThe name, by language code. nameText is one text in the language you ask for.
descriptionA short text. Can be null.
priceamount in the smallest unit of the currency, and currency. 0 is free.
payMethodscard or in_person. Empty for a free tier.
saleStart, saleEndWhen the sale opens and closes. Can be null.
soldOuttrue when no seat is left on this tier for this date.
forYouWhat this tier means for the signed-in member. null for an API key.

saleStart and saleEnd are ISO 8601 times in UTC. Crewcade reads the time on the tier in the time zone of the event.

forYou has three fields.

  • available is true when the member can take the tier now.
  • reason says why the tier is closed. It is tier_disabled, role_restricted, event_full or sold_out. It is payment_required for an open paid tier. It is null for an open free tier.
  • registerVia is api when you can register the member with one call. It is event_page when you must send the member to eventUrl. See Registrations.