Skip to content

Registrations

These endpoints work with a member token from Sign in with Crewcade. The token needs the registrations scope. An API key does not work here.

Your app can sign a member up for a free ticket. Your app can cancel a free signup. A paid ticket stays on the Crewcade event page. Your app sends the member there.

GET /me/registrations
QueryTypeMeaning
whenstringupcoming or past. Default upcoming.
statusstringStatuses to keep, separated by commas. Pick from pending, confirmed, waitlisted, cancelled and no_show. Default: all.
pagenumberThe page to read. Starts at 1. Default 1.
pageSizenumberRegistrations per page. From 1 to 100. Default 20.
  • upcoming means the start time is still ahead. Soonest first.
  • past means the start time has passed. Latest first.
  • A live event shows under past.

Each registration has these fields.

FieldMeaning
idThe registration id.
statuspending, confirmed, waitlisted, cancelled or no_show.
registeredAtWhen the member signed up.
cancelledAtWhen the member cancelled. null if not cancelled.
tierThe ticket: id, name and nameText. Can be null.
paymentStatenone, awaiting, paid, refunded or refund_owed. none means free, or a payment that failed.
eventThe date: id, seriesId, publicId, urlKey, title, titleText, start, end, status and coverImageUrl.
GET /events/{id}/registration

Pass the id of one date. You get the registration of the member for that date. You get 404 with not_registered when the member has none.

POST /events/{id}/registration

This works for free tickets only. If the member has several free tickets, send tierId in the JSON body. Read the tiers with GET /events/{id}. See Events API.

  • The first call answers 201 with the registration.
  • A second call answers 200 with the same registration.
DELETE /events/{id}/registration

You get 204 with no body. Cancelling a signup that is already cancelled also gives 204.

Every error body has code and message.

StatusCodeMeaning
400tier_requiredThe member can take more than one free ticket. Send tierId. The body lists tierIds.
400tier_not_availableThis ticket is not on sale for this date.
400event_pastThe date has already started.
400registration_refusedThe club does not allow this signup. The message says why.
401invalid_tokenThe token is bad.
403insufficient_scopeThe token has no registrations scope.
403TICKET_TIER_ROLE_RESTRICTEDThe ticket is only for members with a certain role.
404not_registeredThe member has no registration for this date.
404event_not_foundThe event does not exist, or the member cannot open it.
404event_is_seriesYou sent the id of a recurring series. Send the id of one date.
409payment_requiredThe ticket costs money. Send the member to eventUrl in the body.
409form_requiredThe event asks questions first. Send the member to eventUrl in the body.
409event_fullThe event has no seat left.
409tier_sold_outThis ticket has no seat left.
409refund_openA refund for an earlier ticket is still open. Send the member to eventUrl.
409already_registeredThe member already holds a registration for this date. Look at eventUrl.
409cancel_on_event_pageThe ticket is paid, or was bought with others. The member cancels on eventUrl.
429rate_limitedToo many requests. Wait the seconds in the Retry-After header.