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.
Dates, series and ids
Section titled “Dates, series and ids”The API lists occurrences. An occurrence is one date of an event.
- A one-off event has one occurrence. Its
idis the eventpublicId. - A recurring event has many dates. Each date has its own
id, an 8-character code. All dates share aseriesId, thepublicIdof 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".
List events
Section titled “List events”GET /events| Query | Type | Meaning |
|---|---|---|
from | string | Start of the window. An ISO-8601 time with Z or an offset. Default: now. |
to | string | End of the window, same format. Default: 30 days after from. At most 92 days. |
seriesId | string | Only the dates of this recurring event. |
page | number | The page to read. Starts at 1. Default 1. |
pageSize | number | Dates per page. From 1 to 100. Default 20. |
Dates come back earliest first.
- For upcoming and live dates, leave
fromempty. - For past dates, set
toto now andfromto an earlier time.
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 one date
Section titled “Get one date”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}.
See who is going
Section titled “See who is going”GET /events/{id}/registrationsThis 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.
| Query | Type | Meaning |
|---|---|---|
page | number | The page to read. Starts at 1. Default 1. |
pageSize | number | People per page. From 1 to 100. Default 20. |
{ "data": [ { "memberId": "mem_123", "name": { "en": "Alex Kim" }, "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.
Event fields
Section titled “Event fields”| Field | Meaning |
|---|---|
id | The occurrence id. Use it for every other call. |
seriesId | The publicId of the recurring series. null for a one-off event. |
publicId | The event publicId. For a recurring date, this is the series. |
slug | A readable label. It can change. |
urlKey | The slug-publicId key that Crewcade event links use. |
title | The title, by language code. |
description | The description, by language code. Can be null. |
start, end | dateTime with the offset for that date, and the IANA timeZone. |
timing | upcoming, live or past, worked out when you call. |
status | scheduled or cancelled. |
locationType | in_person, online, hybrid or none. |
venue | name and address. Either can be null. |
hostName | Who hosts that date, by language code. Can be null. |
coverImageUrl | The flyer image. Can be null. |
capacity | Seats. null means no limit. |
spotsRemaining | Seats left. null means no limit. |
properties | Fields your club defines for events, such as a club or a level. |
eventUrl | The address of the event page on Crewcade. The list and one date both have it. |
tiers | The tickets of the date. Only on one date. See below. |
Tickets
Section titled “Tickets”GET /events/{id} returns tiers. A tier is one kind of ticket.
| Field | Meaning |
|---|---|
id | The tier id. Send it as tierId when you register a member. |
name | The name, by language code. nameText is one text in the language you ask for. |
description | A short text. Can be null. |
price | amount in the smallest unit of the currency, and currency. 0 is free. |
payMethods | card or in_person. Empty for a free tier. |
saleStart, saleEnd | When the sale opens and closes. Can be null. |
soldOut | true when no seat is left on this tier for this date. |
forYou | What 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.
availableistruewhen the member can take the tier now.reasonsays why the tier is closed. It istier_disabled,role_restricted,event_fullorsold_out. It ispayment_requiredfor an open paid tier. It isnullfor an open free tier.registerViaisapiwhen you can register the member with one call. It isevent_pagewhen you must send the member toeventUrl. See Registrations.