Retrieves daily RSVP growth data and projections for an event. This endpoint provides both actual RSVP counts (for past days) and dynamically calculated required growth projections (for future days) to help event managers track progress toward attendance goals.
The organization ID that owns the event
The event ID for which to retrieve RSVP growth data
Request The endpoint requires authentication via Bearer token and the user must have event management permissions for the organization.
Response Indicates whether the request was successful
Contains the RSVP growth data Array of daily RSVP data from event creation to the day before the event ISO date string (YYYY-MM-DD) for the day
Number of RSVPs received on this specific day (0 for future days)
Total RSVPs received up to and including this day
Array of required cumulative RSVP targets for each day Show Required Growth Item
ISO date string (YYYY-MM-DD) for the day
Cumulative RSVP target required by this day to meet the event’s expected attendance
The event’s expected attendance target
Total number of days from event creation to the day before the event
Average RSVPs required per day to meet the target (for reference)
ISO timestamp of the event start date
ISO timestamp of when the event was created
Whether the event has passed (data is frozen in time)
Data Calculation Logic Past Days
Uses original predicted cumulative target (not actual RSVPs) for the required growth line
Actual RSVPs are tracked from EventAnalytics.rsvpHistory (primary source) or Event.attendees (fallback)
RSVPs are grouped by day using timestamps, with guest counts included
Future Days
Dynamically recalculates required growth based on actual performance
If behind schedule : remaining days require higher daily RSVP rates
If ahead of schedule : remaining days require lower daily RSVP rates
Ensures the total target is still met by the event date
Data Sources (Priority Order)
EventAnalytics.rsvpHistory - Most accurate, indexed timestampsEvent.attendees.rsvpDate - Fallback if rsvpHistory is emptyEven distribution fallback - If only rsvpStats.going count is available
Error Responses Event not found { "success" : false , "message" : "Event not found" }
Server error during data retrieval { "success" : false , "message" : "Error fetching RSVP growth data" , "error" : "Error message details" }
Example curl -X GET \ https://api.meridian.study/org-event-management/507f1f77bcf86cd799439011/events/507f191e810c19729de860ea/rsvp-growth \ -H 'Authorization: Bearer YOUR_TOKEN_HERE'
{ "success" : true , "data" : { "dailyData" : [ { "date" : "2024-01-15" , "dailyRSVPs" : 5 , "cumulativeRSVPs" : 5 }, { "date" : "2024-01-16" , "dailyRSVPs" : 3 , "cumulativeRSVPs" : 8 }, { "date" : "2024-01-17" , "dailyRSVPs" : 0 , "cumulativeRSVPs" : 8 } ], "requiredGrowth" : [ { "date" : "2024-01-15" , "required" : 10 }, { "date" : "2024-01-16" , "required" : 20 }, { "date" : "2024-01-17" , "required" : 25 } ], "targetAttendance" : 100 , "totalDays" : 10 , "requiredPerDay" : 10 , "eventStart" : "2024-01-25T18:00:00.000Z" , "eventCreated" : "2024-01-15T10:00:00.000Z" , "isFrozen" : false } }
Notes
Date Range : Data spans from event creation date to the day before the event start dateFrozen Events : For past events, data is frozen at the day before the event start (RSVPs after event day don’t count)Dynamic Projections : Future day projections adjust based on actual RSVP performance to ensure the target is still achievableGuest Counts : RSVP counts include guest counts from attendee recordsTimezone Handling : Uses a 1-hour buffer for “today” to account for timezone/server clock differencesUsed in the Event Dashboard’s Overview tab to display the RSVP Growth Chart
