Gets a listing of all scheduled Meetup Events the authenticated member has RSVP'd to that have been announced to the group. This listing is ordered from oldest to most recent by default
This endpoint uses HTTP Link header based pagination. Clients may use the scroll request parameter to jump to a target scroll location. Valid values for scroll targets are defined below. A 'page' parameter may be provided to control the number of results returned.
When true, sorts results in descending order. Defaults to false
A comma-delimited list of optional fields names which may be appended to the response
An optional timestamp that represents a lower time bound (inclusive) for the start time of events in the local time of the group. If provided, it must be a string in ISO 8601 format without a time zone specified, i.e. 2018-06-01T00:00:00.000. If provided, the API will not return events with a start time earlier than the time specified by this parameter. If both this parameter and scroll are present, such that scroll does not have a type of ctime and it requests events that start after the specified scroll time, then the API returns events after whichever of scroll and no_earlier_than comes later.
An optional timestamp that represents an upper time bound (exclusive) for the start time of events in the local time of the group. If provided, it must be a string in ISO 8601 format without a time zone specified, i.e. 2018-06-01T00:00:00.000. If provided, the API will not return events with a start time later than or equal to the time specified by this parameter. If both this parameter and scroll are present, such that scroll does not have a type of ctime and it requests events before the specified scroll time, then the API returns events before whichever of scroll and no_later_than comes earlier.
Number of results to return. Defaults to 200.
Comma-delimited list of RSVP responses. Valid values are "waitlist" or "yes". The default is "yes"
A string representing an alias for a point on a timeline.
Supported values are as follows.
recent_past: Scroll to the last RSVP'd Meetup Event that has passed. If there is no recent RSVP, this defaults to next_upcoming
next_upcoming: Scroll to the next upcoming Meetup Event the authenticated member RSVP'd to.
Alternatively the server may generate a scroll value used for pagination Link headers. Clients should treat the contents of those as a transparent string. Its contents are subject to change in the future
Comma-delimited list of event statuses. Valid values are "past" or "upcoming"
Returns a list of Events the authenticated Member has RSVP'd in order of oldest to most recent
Number of all members marked as attended, yes RSVPs that were not changed by attendance and their guests
A small collection of members marked as attended and yes RSVPs that were not changed by attendance
A small collection of attendance records of members marked as attended and yes RSVPs that were not changed by attendance. For upcoming events, this represents collection of yes RSVPs
An aggregate count of all comments and replies for a given event, returned when fields request parameter value includes 'comment_count'
Creation time of the event, in milliseconds since the epoch
Is event date matches the series pattern
Description of the event in HTML. Email addresses and phone numbers will be masked for non-members
A list of image urls included in the event description. returned when "fields" request parameter value contains "description_images, only supported for GET /event/:id currently"
Scheduled event duration in milliseconds, if an end time is specified by the organizer. When not present, a default of 3 hours may be assumed by applications
List of members hosting the event, returned when fields request parameter value includes 'event_hosts'
Number of times member hosted for group
Host member's id
Host member's introduction
Group join date in milliseconds since epoch
Host member's name
Member photo if one exists
A base url that can be use to construct a photo url from its components
Link for full sized photo
Numeric photo ID
Link for standard sized photo
Link for thumbnail sized photo
Type of photo. One of "event" or "member"
Boolean indicator of whether or not a given event is featured, returned when fields request parameter value includes 'featured'
A featured photo for this event, returned when the 'fields' request paramater includes 'featured_photo'
A base url that can be use to construct a photo url from its components
Link for full sized photo
Numeric photo ID
Link for standard sized photo
Link for thumbnail sized photo
Type of photo. One of "event" or "member"
Ticketing fee information for events that support payments
Acceptable methods of payments may be one of "paypal", "wepay", "stripe", or "cash"
Amount of the fee
Currency accepted for fee
Fee description, typically "per-person"
Label for fee, typically "Price"
Boolean flag indicating if this fee is required to RSVP
Payment options for event ticketing, returned when the 'fields' request parameter value includes 'fee_options'
Acceptable currencies for the payment method specified by type
Currency accepted for fee
A boolean set to true if the currency is the group's default currency, false otherwise
A boolean set to true if the payment method specified by 'type' is set up for the group
The URL for setting up the payment method specified by 'type'. This is returned if the payment method specified by 'type' is not set up for the group and the member has the permission to set it up
Acceptable methods of payments may be one of Set(none, cash, paypal, stripe)
Information about group hosting the event
Category group belongs to, returned when fields request parameter value includes 'group_category'
Numeric category id
Display name of the category
String identifier of the category
Name used for sorting
Country of the group
Numeric identifier for the group
Lists any questions requested when joining and required fields. Returned with "fields" request parameter value includes "group_join_info"
true if required, false otherwise
List of profile questions organizer would like new members to answer prior to joining
true if required, false otherwise
Indicator of how new members may be able to join. be one of "open", "approval" or "closed"
Group primary photo, returned when fields request parameter value includes 'group_key_photo'
A base url that can be use to construct a photo url from its components
Link for full sized photo
Numeric photo ID
Link for standard sized photo
Link for thumbnail sized photo
Type of photo. One of "event" or "member"
Approximate group latitude
City/State or City/Country of the group
Approximate group longitude
Membership dues information associated with hosting group, returned when fields request parameter value includes 'group_membership_dues'
Currency in which the fee is declared
Links to dues management and checkout pages.
Numeric fee value
The interval at which dues must be paid. Possible values may include: "month", "year", "day", or "every other day"
Methods of payments
Array of reasons containing one or more of the following values compensate_organizer, cover_costs, encourage_engagement, improve_meetups, other, provide_supplies, reserve_fund
An additional reason if specified.
Conditions for refunds
true if dues are required
If the dues are required this indicates what they are required for. Currently may only be 'join'
Returns true if the authorized user is prevented from participating in the group until a payment is made
When present, returns the number of days the group is offering a free trial period for to new members. When not present, this indicates that the group does not offer a trial membership period
The meta category of the group, if the group has one, returned when fields request parameter value inclues 'meta_category'
Represents the best topic matches for this category, returned when the "fields" request parameter value includes "best_topics"
List of numeric category ids associated with this topic category
Numeric topic-category id
Display name of the topic-category
Photo representing this category
Unique string identifier for this category
Name used for sorting
Name of the group
The number of past events belonging to the group, returned when "fields" includes "group_past_event_count"
Photo associated with group, returned when fields request parameter value includes 'group_photo'
A base url that can be use to construct a photo url from its components
Link for full sized photo
Numeric photo ID
Link for standard sized photo
Link for thumbnail sized photo
Type of photo. One of "event" or "member"
Color combination used to generate group duotone, returned when fields request parameter value includes 'group_photo_gradient'
Composite color in hexidecimal format
Dark color in hexidecimal format
Unique numeric identifier
Light color in hexidecimal format
Information on group's Pro organization, returned when "fields" request parameter value includes "group_pro_network"
Language and region of the group
Information pertaining to the authenticated member with respect to the group, returned when fields request parameter value includes 'group_self_profile', 'group_self_actions', 'group_self_membership_dues', or 'group_self_status'
list of actions the authenticated member may perform, potentially "event_create": the ability to create new events, "event_draft": the ability to save new events as drafts, "role_assign": the ability to assign member roles, "edit": the ability to edit group settings, "member_approval": the ability to approve or decline member requests to join, or "subscription_upgrade": the ability to upgrade this group's subscription plan
Membership dues information associated with hosting group, returned when "fields" request parameter value includes "group_membership_dues" and group has dues
Profile of the authenticated member
Indicates the authorized user's membership with this group.
Value may be one of "none", "pending", "pending_payment", "active", or "blocked"
State of the group
Timezone of group
Topics related to the group, returned when fields request parameter value includes 'group_topics'
Numeric topic id
Language topic originates from
Display name of the topic
The unique keyword used to identify this topic
Alphanumeric urlname identifier for the group
Group visibility, returned when fields request parameter value includes 'group_visibility'. Value may be "public", "public_limited", or "members".
What the group calls its members
Additional information on how to find members at a venue when provided by an organizer, returned when fields request parameter value includes 'how_to_find_us'
A unique alphanumeric identifier for event
Is event happening online
Link to event on meetup.com
The local date of the Meetup in ISO 8601 format
The local time of the Meetup in ISO 8601 format
Manually entered total attendee headcount, if any exists
Name of the event
Number of past events that happened before and including this event. Returned when "fields" request parameter value contains "past_event_count_inclusive"
Information about photo uploads for this event, returned when fields request parameter value includes 'photo_album'
Event photo album belongs to. This will be absent if the album is not associated with an event
Alphanumeric event ID
Name of event
Number of no RSVPs, included if the rsvp_counts field is set
UTC start time of the event, in milliseconds since the epoch
The local offset from UTC time, in milliseconds
Number of waitlisted RSVPs, included if the rsvp_counts field is set
Number of yes RSVPs
Unique numeric identifier for photo album
Number of photos uploaded
A small collection of photos uploaded for this event
A base url that can be use to construct a photo url from its components
Link for full sized photo
Numeric photo ID
Link for standard sized photo
Link for thumbnail sized photo
Type of photo. One of "event" or "member"
Album title
Plain text version of the event description. Email addresses and photo numbers will be masked for non-members. Returned when "fields" request parameter value contains "plain_text_description"
Plain text version of the event description without images. Email addresses and photo numbers will be masked for non-members. Returned when "fields" request parameter value contains "plain_text_no_images_description"
The amount of time between when RSVPs close and the start time of the Meetup in ISO 8601 format
The number of "yes" RSVPS an event has capacity for
The amount of time between when RSVPs open and the start time of the Meetup in ISO 8601 format
Information about conditions that allow for member RSVPs, returned when fields request parameter value include 'rsvp_rules'
UTC time that RSVPs will no longer be accepted, though organizers may close RSVPs earlier
Boolean value indicating whether or not RSVPing was explicitly closed for the event.
Number of guests members may include in their RSVP, 0 or more
UTC time that members may begin to RSVP
The organizer-defined terms for refunds. If this is defined, you must provide the authenticated member a way to access this information before they can RSVP. They will need to agree to these terms before they RSVP
if member_cancellation is present, it's relative to this many days before the event
additional refund policy notes
list of one or more of the following. 'no_refunds' if the organizer will not issue refunds', 'member_cancellation' if the organizer offers a refund for member cancellation, 'event_cancellation' if the organizer offers a refund if the event is canceled, 'event_rescheduled' if the organizer offers a refund when the event is rescheduled
Wait list handling when RSVP limit is reached. Value may be one of 'auto', 'manual' or 'off'
A small collection RSVPs for members attending this event, returned when fields request parameter value includes 'rsvp_sample'
Creation time of the RSVP, in milliseconds since the epoch
Unique numeric identifier for the RSVP. May be -1 for events scheduled in the future
Member who RSVP'd
Intro of member
Member's context within the event. Only returned in the context of an event
Numeric member ID
Name of member
Member photo, if available. Members who registered via Facebook may not have highres photos
The leadership role of this member within the group, if any. Value may be one of assistant_organizer, coorganizer, event_organizer, organizer
Represents the authenticated member's relation to member. Returned with the "fields" request parameter includes "self" and the target member is not the authenticated member
Organizer defined title of member. May be absent if not defined
Last modified time of the RSVP, in milliseconds since the epoch
Boolean value indicating whether or not the authenticated member can RSVP or join the waitlist when the event is full. Returned when the "fields" request parameter value includes "rsvpable"
Boolean value indicating whether or not the authenticated member can RSVP after joining the hosting group. Returned when the "fields" request parameter includes "rsvpable_after_join" and the authenticated member is not a member of the group hosting this event
Whether the authorized member has saved the event, returned when fields request parameter value includes 'saved'
represents details particular to the authorized user, only present if requested and authenticated member is a member of the hosting group, returned when fields request parameter value includes 'self'
List of actions the authenticated member may perform, potentially one or more of the following
"announce" to announce the event to the group's members
"attendance" to view or take attendance for the event
"copy" the ability to copy an event
"comment" the ability to post a comment or reply
"payments" the ability to mark members as paid if the event is ticketed
"publish" to publish a draft event
"edit" to edit the event information
"edit_hosts" to edit the hosts for the event
"email_attendees" the ability to email event attendees
"delete" to delete the event
"rsvp" to RSVP yes or no to the event
"wait" to get on the waiting list (using the same RSVP methods).
"dues" if an organizer requires membership dues to RSVP and the authorized member has not paid theirs
"upload_photo" the ability to upload a photo for the event
"cancel" the ability to cancel the event
"close" the ability to close the RSVPs for the event
"open" the ability to open the RSVPs for the event
"invite" the ability to invite someone for the event
"download_attendees" the ability to download the attendees list for the event
"take_attendance" the ability to take attendance for the event
"delete_cancelled" the ability to delete the event if it is cancelled
The authenticated member's payment status. This may be one of 'none', 'paid', 'partially_paid', 'payment_pending', 'echeck_pending', 'refund_pending', 'partially_refunded', 'refunded'
The authenticated member's role in within the group, if any. This may be one of: Organizer, Assistant Organizer, Event Organizer, etc.
Member's RSVP, if any
List of answers to event survey questions asked when the member RSVP'd in the order asked, only available to organizers and assistant organizers
Number of guests the RSVP'd member will be bringing
May be "yes" or "no".
In cases where an event is over capacity and the member has shown an intent to attend, response may be "waitlist" if the event has a waitlist.
In cases of ticketed events, this may be "yes_pending_payment" for a "yes" response for a ticketed event with an unprocessed payment
Returned when the "fields" request parameter value includes "series" for events that are part of a series of events
Human displayable description of how often events in this series occur
Date when this series ends/ended, in milliseconds since the epoch
Unique numeric identifier for the series
Returned for events that are part of a monthly recurring series of events
Integer value between 1-7 (Monday-Sunday) for the day of week the recurrence occurs upon
Integer number of months between each recurrence
Integer value between 1-5 representing the week number on which the event recurs. A value of 5 indicates the event recurs on the last week of every month
Date when this series begins/began, in milliseconds since the epoch
Unique numeric identifier for the template event of the series
Returned for events that are part of a weekly recurring series of events
List of integers 1-7 (Monday-Sunday) of days of week recurrence occurs upon
Integer number of weeks between each recurrence
A shortened link for the event on meetup.com, returned when fields request parameter value includes "short_link"
Description of the event, in simple HTML source format. If this event's description was saved in simple HTML format, the description field will be an HTML translation of this source. Returned when the "fields"' request parameter contains "simple_html_description"
Status of the event. May be one of "upcoming" or "past"
List of organizer-defined survey questions intended to be asked of RSVPing members. Returned when the "fields"' request parameter contains "answers"
Numeric question identifier
Question text
UTC start time of the event, in milliseconds since the epoch
Last modified time for the event in milliseconds since the epoch
The local offset from UTC time, in milliseconds
The event venue, present only if selected and not hidden by an organizer
Line 1 of venue address
Line 2 of venue address
Line 3 of venue address
City of venue
Country code of venue
Unique numeric venue id
Approximate latitude
The localized name of the venue's country
Approximate longitude
Venue name
Phone number of venue
true if the editor of the event altered the original venues pin location, false otherwise
State of venue where available
ZIP code if, venue is in US or Canada
Represents who can see the venue with a potential value of "members" or "public", returned when fields request parameter value includes "venue_visibility" and the authenticated member is a member of the group hosting the event
Event visibility: "public", "public_limited", or "members". Events in private groups that do not expose limited information are visible only to that group's members and should not be made public.
Number of members on the waitlist, if one exists
Set of "Invite" and google/yahoo/ical/outlook "Add to calendar" web actions
We should do this because...
Number of yes RSVPs including guests
v3 comments