Get a public event
Event details, form fields, theme and counts for the widget. No guest personal data. Private, draft and unknown events all answer 404 `event_not_found`. No key needed. CORS is open to any origin. Cached at the CDN for 15 seconds (`s-maxage=15, stale-while-revalidate=60`).
Event details, form fields, theme and counts for the widget. No guest personal data. Private, draft and unknown events all answer 404 event_not_found. No key needed. CORS is open to any origin. Cached at the CDN for 15 seconds (s-maxage=15, stale-while-revalidate=60).
id*string^evt_[0-9A-Za-z]{6,64}$The event.
application/json- response
What a guest may see about an event. Counts only, never guest names.
id*stringmode*stringlive or test. Always the mode of the API key that made the request.
"live""test"title*stringdescription*string|nullstarts_at*stringISO 8601 with a UTC offset.
date-timeends_at*|ISO 8601 with a UTC offset.
date-timetimezone*stringlocation_name*string|nulllocation_address*string|nullonline_url*string|nullprice_note*string|nullcover_image_url*string|nullstatus*string"draft""published""cancelled"visibility*stringPrivate events are never served here (404 event_not_found).
"public""unlisted"state*stringWhat the widget should show: open, full_waitlist (full, new RSVPs join the waitlist), full, ended or cancelled. New values may be added; treat an unknown one like open without the RSVP button.
"open""full_waitlist""full""ended""cancelled"capacity*integer|nullmax_guests*integerwaitlist_enabled*booleancounts*fields*array<>url*stringcalendar*organizer*branding*turnstile_site_key*|Null when no bot check is configured; the RSVP then needs no token.
curl -X GET 'https://api.whocoming.com/v1/public/events/string'{ "id": "string", "mode": "live", "title": "string", "description": "string", "starts_at": "2019-08-24T14:15:22Z", "ends_at": "2019-08-24T14:15:22Z", "timezone": "string", "location_name": "string", "location_address": "string", "online_url": "string", "price_note": "string", "cover_image_url": "string", "status": "draft", "visibility": "public", "state": "open", "capacity": 0, "max_guests": 0, "waitlist_enabled": true, "counts": { "going": 0, "waitlisted": 0, "spots_left": 0 }, "fields": [ { "key": "string", "label": "string", "type": "text", "required": true, "options": [ "string" ] } ], "url": "string", "calendar": { "ics_url": "string", "google_url": "string" }, "organizer": { "id": "string", "name": "string", "slug": "string", "logo_url": "string", "accent_color": "string" }, "branding": { "show_badge": true }, "turnstile_site_key": "string"}Export a guest's data GET
Everything held about one email address, for a data access request. Requires the `rsvps:read` scope.
Download the event as a calendar file GET
An iCalendar (.ics) file for "Add to calendar". A cancelled event has `STATUS:CANCELLED`. Private, draft and unknown events answer 404 `event_not_found`. No key needed. CORS is open to any origin. Cached at the CDN for 15 seconds (`s-maxage=15, stale-while-revalidate=60`).