Events
Events (#2483): the list of live events, an event page with its viewer block, and the forms on it (volunteer, sponsor this dinner, report). Behind features.events: while it is off every operation answers 404, except to staff with manage_events. Drafts, events in review and suspended events answer 404 to anyone but their hosts and staff. Refusals come as EventError.
List events
Live, listed, not suspended events as list rows: upcoming (soonest first, the default) or past (latest first). Feeds /events, city, community and host pages and the Fundly page. Filters take an id or a slug (member and fundraiser: an id). A sponsor's events are the ones it hosts and the ones it sponsors (sponsor_role for one of the two). A community's active members also get its members-only events that are not listed on /events (#2495). The first page (no cursor) says how many rows the filters match in all (total). No account needed; 404 while Events are switched off (features.events).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Query Parameters
"upcoming""past""upcoming"A city place's id or slug.
"free""paid"Id or slug of a hosting community.
Id or slug of a hosting non-profit or church.
Id or slug of a sponsor that hosts or sponsors.
With sponsor (#2495), only the events it hosts or only the ones it sponsors; both when left out.
"hosting""sponsoring"A hosting member.
"uuid"A Fundly the events raise money for.
"uuid"next_cursor of the page before.
2050Responses
One page of rows.
Event link-preview image
The event's 1200×630 Open Graph picture: its complete cover fitted inside the frame without cropping invitation text or logos, or a card with its title, date and place. Public and cached for five minutes, one answer per URL whoever asks; an event a stranger may not see is the same 404 as an unknown link.
Parameters
Path Parameters
Query Parameters
Language to render in. Without it the locale cookie, then Accept-Language, decide.
"en""ru""uk""es"The cover and preview-layout version, so a new cover or layout is a new URL. Ignored by the server.
The complete cover fitted inside this shape. Unused space uses the event theme background.
"square""4x3""16x9"Responses
The picture.
Event square share poster
A 1080×1080 picture for feed posts (#2490). Same data, language rules, caching and 404 as the link-preview image.
Parameters
Path Parameters
Query Parameters
Language to render in. Without it the locale cookie, then Accept-Language, decide.
"en""ru""uk""es"The cover's version, so a new cover is a new URL. Ignored by the server.
Responses
The picture.
Event story card
A 1080×1920 picture for Instagram and Facebook Stories (#2490). Same data, language rules, caching and 404 as the link-preview image.
Parameters
Path Parameters
Query Parameters
Language to render in. Without it the locale cookie, then Accept-Language, decide.
"en""ru""uk""es"The cover's version, so a new cover is a new URL. Ignored by the server.
Responses
The picture.
The event page
The event, its days, hosts, ticket types with availability, sponsors, volunteer roles with open slots, linked Fundlies with raised, photos, the computed sale status and the viewer block. A live event that is not suspended is public; a draft, an event in review, with changes requested, rejected or suspended answers 404 to anyone but its hosts and staff. An old link answers 301 to the current one. Never cached by a shared cache.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
Responses
The page.
People going to an event
A private, no-store, paginated identity list. Public readers see only active opted-in buyer profiles. Accepted hosts and authorized event staff may also see member guests and named guests without accounts. Emails, booking/payment details and ticket codes are never included. The event-page visibility gate applies; hidden attendee lists return 404. Each request rechecks the viewer's access.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
"uuid"Query Parameters
251100Responses
The people visible to this viewer, the total attendance count and next cursor.
Volunteer from the page
A sign-up to a role open to sign-ups, on a live event that has not ended, for the hosts to approve (requested). Signed in, the person is the volunteer; signed out, name and email are required. 5 a minute per address.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
Signed up.
"Sponsor this dinner"
A business asks to sponsor a live event that has not ended; the hosts see it in the Sponsors tab. 5 a minute per address.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
Sent.
Report an event
"Something wrong with this event? Report". Signed in with a verified email; one report per person and event (a second replaces the first). Hosts cannot report their own event. Staff review reports; nothing is taken down automatically.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
Reported.