Extend your community

Events

GET /2/events
  • json
  • xml
Host: api.meetup.com
  • basic
api version 2

Access Meetup events using a group, member, or event id. Events in private groups are available only to authenticated members of those groups. To search events by topic or location, see Open Events.

Try it in the console

Request Parameters

At least one of the required parameter(s) must be supplied with the request. Some groups, while remaining private, still wish to show some information about their events. You can include these events in results using the limited_events request parameter.

event_id

Multiple ids may be separated with commas

fields

Request that additional fields (separated by commas) be included in the output

group_domain

Group custom domain

group_id

Multiple ids may be separated with commas

group_urlname

Path to group from meetup.com, no slashes

limited_events

Include limited event information for private groups that wish to expose only a small amount of information about their events. This includes just: id, name, utc_offset, time, duration, yes_rsvp_count, waitlist_count, group, visibility, timezone. Value must be true or false.

member_id

Single member id, to find events in this member's groups

rsvp

Filters events by the currently authenticated member's RSVP status. May be a comma delimited list of "yes", "no", "waitlist", "maybe" or "none"

status

Status may be "upcoming", "past", "proposed", "suggested", "cancelled", "draft" or multiple separated by a comma. The default is "upcoming", which includes Meetups that are happening now according to their duration. Meetups that are "proposed" or "suggested" do not have a date assigned; the former are listed on the site as official while the latter appear as in the making. Drafts are only visible to organizers of groups hosting the events.

text_format

Format of the description text, "html" or "plain". Defaults to "html"

time

Return events scheduled within the given time range, defined by two times separated with a single comma. Each end of the range may be specified with relative dates, such as "1m" for one month from now, or by absolute time in milliseconds since the epoch. If an endpoint is omitted, the range is unbounded on that end. The default value is unbounded on both ends (though restricted to the search window described above). Note: to retrieve past events you must also update status value

venue_id

Multiple ids may be separated with commas

Ordering

time

(default order) ascending

Response

announced

Organizers and hosts can see if the event was announced

announced_at

Organizers and hosts can see when the event as announced in milliseconds since the epoch

comment_count

Returned when fields request parameter contains "comment_count" and represents number of comments posted to the event

created

UTC creation time of the event, in milliseconds since the epoch

description

Description of the event.

distance

Distance in miles from the search location, if one was specified

duration

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.

email_reminders

Returned when fields request parameter contains "email_reminders" and is limited to organizers and event hosts, if false, event reminders are disabled

event_hosts

List of members hosting the event, only returned if requested in the fields parameter.

member_id

The host's member id

member_name

The host's member name

event_url

URL of the event's page on meetup.com

featured

Returned when fields request parameter contains "featured" and returns "true" if the event is featured and "false" otherwise

fee

Fee info returned when payment is defined

accepts

Accepted method of payment. Can be one of "paypal", "amazon", or "cash"

amount

Amount of the fee

currency

Currency accepted for fee

description

Fee description, typically "per person"

label

Fee label, typically "Price"

required

"1" if payment is required to RSVP, "0" otherwise

group

Group that is hosting the event

approved

Returned when fields request parameter contains "group_approved". True if this group has been approved. New groups are generally approved (or removed) soon after creation.

category

Optional field. Category of this group

id

Numeric identifier of the category

name

Display name of the category

shortname

String identifier of the category

created

Date and time that the group was founded, in milliseconds since the epoch

group_lat

Approximate group latitude

group_lon

Approximate group longitude

group_photo

Returned when fields request parameter contains "group_photo" and represents photo for the group hosting the event

highres_link

URL for the photo at its maximum size

photo_id

-

photo_link

URL for a standard size of the photo

thumb_link

URL for a thumbnail of the photo

id

Group id

join_mode

"open", "approval", or "closed"

membership_dues

Returned when fields request parameter contains "group_membership_dues"

currency

Currency fee is declared as

fee

Numeric fee value

fee_desc

Description of fee

methods

Array of acceptable payment methods. May be one or more of "amazon_payments", "paypal", "credit_card" or "other"

reasons

Array of reasons types in the following values compensate_organizer, cover_costs, encourage_engagement, improve_meetups, other, provide_supplies, reserve_fund

reasons_other

An additional reason if specified.

refund_policy

Array of payment refund policies. May be one or more of "none", "member_leaves", "group_closes", "member_banned", or "custom"

required

"2" if dues are required to join, "1" if dues are required to RSVP, "0" otherwise

self_payment_required

Returns true if the authorized user is prevented from participating in the group until a payment is made

trial_days

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

name

Group name

self

Returned when fields request parameter contains 'self_membership_dues' or 'group_status'

membership_dues

The authenticated member's group dues in the form returned by group endpoints

status

The member's status. May be one of 'active' or 'pending'

topics

Optional field. Topics related to this group

id

Topic ID

name

Topic name

urlkey

Unique keyword used to identify this topic

urlname

Group URL name

who

What the group calls its members

headcount

The number of members in attendance according to the attendance taker. This may be 0 if attendance has not yet been taken

how_to_find_us

The information provided by the event host for "How will members find you there?". Visible when location is visible to the authenticated member

id

The event id. May be numeric or alphanumeric, always served as a string

is_simplehtml

Optional field, "true" when the event has been saved in a simplified HTML format, "false" otherwise.

maybe_rsvp_count

Number of maybe RSVPs including guests

name

The name of the event

photo_album_id

Returned when fields request parameter contains "photo_album_id" and returns the ID of the photo album for this event, if one exists

photo_count

Returned when fields request parameter contains "photo_count" and represents number of photos posted to the event

photo_url

URL of the event photo, if one exists

publish_status

"published" or "draft" only visible to organizers

rating

Only past events have this field, an aggregate of anonymous ratings

average

Average of collected ratings

count

Number of ratings been collected

rsvp_alerts

Returned when fields request parameter contains "rsvp_alerts" and is limited to organizers and event hosts, if false, member RSVP alerts are disabled

rsvp_limit

The number of "yes" RSVPs an event can have before members will be added to the waiting list

rsvp_rules

Conditions set by the organizer, only returned if requested in the fields parameter.

close_time

UTC time that RSVPs will no longer be accepted, though organizers may close RSVPs earlier

closed

Flag indicating that RSVPing is closed for the event. 1 is true 0 is false

guest_limit

Number of guests members may include in their RSVP, 0 or more

open_time

UTC time that members may begin to RSVP

refund_policy

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

days

if member_cancellation is present, it's relative to this many days before the event

notes

additional refund policy notes

policies

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

waitlisting

Wait list handling when RSVP limit is reached. Value may be one of "auto", "manual" or "off"

rsvpable

Indicates if the currently authenticated member can RSVP or not, only returned if requested in the fields parameter

self

Returned when fields request parameter contains "self" and represents details particular to the authorized user, only present if requested and user is a member of the hosting group

actions

list of actions the current user may perform, potentially: "announce" to announce the event to the group's members, "attendance" to view or take attendance for the event, "payments" to mark members as paid if the event is a paid event, "publish" to publish a draft event, "edit" to edit the event information, "edit_hosts" to edit the hosts for the event, "delete" to delete the event, "rsvp" to RSVP yes or no to the event, or "wait" to get on the waiting list (using the same RSVP methods). For events without a waitlist, you may see either "watch" or "unwatch" to watch for opening spots for the event when the event is full. If an organizer requires membership dues to rsvp and the authorized member has not paid theirs, "dues" will be included

pay_status

The authenticated member's payment status. This may be one of 'none', 'paid', 'partially_paid', 'payment_pending', 'echeck_pending', 'refund_pending', 'partially_refunded', 'refunded'.

rated

Boolean indicator of whether the current member rated the event or not

role

The authenticated member's role in within the group, if any. This may be one of: Organizer, Assistant Organizer, Event Organizer, etc.

rsvp

Member's RSVP, if any

answers

List of answers to event survey questions asked when the member RSVP'd in the order asked, only available to organizers and assistant organizers. By default, this field returns a list of strings answers. You can request more structured answer info including the time the answer was updated, by setting fields=rsvp_answer_info in the request. The structured format for answers is defined in Rsvp API's response

guests

number of guests

response

"yes", "no", or "waitlist"

watching

For events without waitlist you may check your watchlist status with this property. Values may either be true of false.

short_link

Returned when fields request parameter contains "short_link". If hosting group is private, this will return the group's short_link

simple_html_description

Optional field, description of the event in simple HTML format.

status

"cancelled", "upcoming", "past", "proposed", "suggested" or "draft"

survey_questions

Returned when fields request parameter contains "survey_questions" for events with surveys

id

Question identifier

question

Question text

required

Flag indicating if a response to this question is required to RSVP. Currently always false.

time

UTC start time of the event, in milliseconds since the epoch

timezone

Returned when fields request parameter contains "timezone". This represents the universal timezone identifier for the host group

trending_rank

Indicates the trending rank within the current result set. The best rank is zero, increasing rank values are less "trending". This value is only returned if requested in the fields parameter

updated

UTC last modified time of the event, in milliseconds since the epoch

utc_offset

The local offset from UTC time, in milliseconds

venue

Venue, if selected and not hidden

address_1

Line 1 of venue address

address_2

Line 2 of venue address

address_3

Line 3 of venue address

city, state, country

City, Country and if in US state of venue

id

Venue id

lat, lon

Geographic coordinates of venue

name

Venue name

phone

Phone number of venue

repinned

true if the editor of the event altered the original venues pin location, false otherwise

zip

ZIP code if, venue is in US or Canada

venue_visibility

Set to "members" or "public". The "venue" element will not be present if the visibility is "members" and the current authenticated user is not a member of the group hosting the event. This value is only returned if requested in the fields parameter

visibility

Event visibility: "public", "members" or "public_limited". Events in private groups that do not expose limited information are visible only to that group's members and should not be made public.

why

We should do this because...

yes_rsvp_count

Number of yes RSVPs including guests

Examples

Upcoming and current events in ny-tech: Console →

Upcoming and current events in ny-tech including my status: Console →

API methods