addressalign-toparrow-leftarrow-leftarrow-right-10x10arrow-rightbackbellblockcalendarcameraccwcheckchevron-downchevron-leftchevron-rightchevron-small-downchevron-small-leftchevron-small-rightchevron-small-upchevron-upcircle-with-checkcircle-with-crosscircle-with-pluscontroller-playcredit-cardcrossdots-three-verticaleditemptyheartexporteye-with-lineeyefacebookfolderfullheartglobe--smallglobegmailgooglegroupshelp-with-circleimageimagesinstagramFill 1languagelaunch-new-window--smalllight-bulblinklocation-pinlockm-swarmSearchmailmediummessagesminusmobilemoremuplabelShape 3 + Rectangle 1ShapeoutlookpersonJoin Group on CardStartprice-ribbonprintShapeShapeShapeShapeImported LayersImported LayersImported Layersshieldstartickettrashtriangle-downtriangle-uptwitteruserwarningyahooyoutube
We've migrated to a new GraphQL framework!
Already have a token? Switching to GraphQL is easy with these migration instructions. Note that REST API support will stop on January 31, 2022. As we prepare to deprecate the REST API, we will be browning it out on January 19, 2022 from 12:00pm to 6:00pm EST and January 28, 2022 from 6:00am to 6:00pm EST. REST endpoints will not work during those times.
For new API users, learn more about the Meetup GraphQL API.

Extend your community

Ordered set of upcoming events from groups affiliated to the Pro Organization

GET /pro/:urlname/events
  • json
Host: api.meetup.com
  • basic
api version 3

An ordered set of timeboxed events from the groups in the Pro Organization

Try it in the console

Request Parameters

All parameters are optional.

country

String: Country

eventsType

String: type of events to fetch. Accepted values: 'online', 'inPerson' and 'both'. 'both' type is by default

lat

Float: Latitude

lon

Float: Longitude

radius

Float: search radius. Max accepted value: 200.0. By default, radius for events is Infinity

size

Integer: amount of events to pull. By default: 8. Max value: 100

zip

String: Zip code

Response

chapter

Description of the associated chapter

average_age

Average age of the group members

category

Categories that the group belongs to

id

Id of the category

name

Name of the category

shortname

Abbreviated name of the category

city

City of the group

country

Country of the group

description

Description of the group

founded_date

Date when the group was founded

gender_female

Proportion of members who identify as female

gender_male

Proportion of members who identify as male

gender_other

Proportion of members who identify as gender other than male or female

gender_unknown

Proportion of members whose gender is unknown

id

Id of the group

last_event

Date of the last meetup event, not present if the group never had a meetup event

lat

Latitude

lon

Longitude

member_count

Number of the group members

name

Name of the group

next_event

Date of the next meetup event, not present if the group has no event scheduled

past_events

Number of the past meetup events

past_rsvps

Number of total RSVPs in the past

pro_join_date

Date when the group joined the Pro organization

repeat_rsvpers

Number of members who RSVPed to a past event and RSVPs to a new event

rsvps_per_event

Average number of RSVPs per event

state

State of the group, if in US or Canada

status

Status of the group, one of Active | Delisted | Inactive

topics

Topics that are assigned to the group

id

Id of the topic

lang

Locale of the topic

name

Name of the topic

urlkey

Urlkey used to identify the topic on meetup.com

upcoming_events

Number of the upcoming meetup events

urlname

Urlname used to identify the group on meetup.com

event

Description of event

attendance_count

Number of all members marked as attended, yes RSVPs that were not changed by attendance and their guests

attendance_sample

A small collection of members marked as attended and yes RSVPs that were not changed by attendance

attendee_sample

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

comment_count

An aggregate count of all comments and replies for a given event, returned when fields request parameter value includes 'comment_count'

created

Creation time of the event, in milliseconds since the epoch

date_in_series_pattern

Is event date matches the series pattern

description

Description of the event in HTML. Email addresses and phone numbers will be masked for non-members

description_images

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"

duration

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

event_hosts

List of members hosting the event, returned when fields request parameter value includes 'event_hosts'

host_count

Number of times member hosted for group

id

Host member's id

intro

Host member's introduction

join_date

Group join date in milliseconds since epoch

name

Host member's name

photo

Member photo if one exists

featured

Boolean indicator of whether or not a given event is featured, returned when fields request parameter value includes 'featured'

featured_photo

A featured photo for this event, returned when the 'fields' request paramater includes 'featured_photo'

base_url

A base url that can be use to construct a photo url from its components

highres_link

Link for full sized photo

id

Numeric photo ID

photo_link

Link for standard sized photo

thumb_link

Link for thumbnail sized photo

type

Type of photo. One of "event" or "member"

fee

Ticketing fee information for events that support payments

accepts

Acceptable methods of payments may be one of "paypal", "wepay", "stripe", or "cash"

amount

Amount of the fee

currency

Currency accepted for fee

description

Fee description, typically "per-person"

label

Label for fee, typically "Price"

required

Boolean flag indicating if this fee is required to RSVP

fee_options

Payment options for event ticketing, returned when the 'fields' request parameter value includes 'fee_options'

currencies

Acceptable currencies for the payment method specified by type

is_setup

A boolean set to true if the payment method specified by 'type' is set up for the group

setup_link

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

type

Acceptable methods of payments may be one of Set(none, cash, paypal, stripe)

group

Information about group hosting the event

category

Category group belongs to, returned when fields request parameter value includes 'group_category'

country

Country of the group

id

Numeric identifier for the group

join_info

Lists any questions requested when joining and required fields. Returned with "fields" request parameter value includes "group_join_info"

join_mode

Indicator of how new members may be able to join. be one of "open", "approval" or "closed"

key_photo

Group primary photo, returned when fields request parameter value includes 'group_key_photo'

lat

Approximate group latitude

localized_location

City/State or City/Country of the group

lon

Approximate group longitude

membership_dues

Membership dues information associated with hosting group, returned when fields request parameter value includes 'group_membership_dues'

meta_category

The meta category of the group, if the group has one, returned when fields request parameter value inclues 'meta_category'

name

Name of the group

past_event_count

The number of past events belonging to the group, returned when "fields" includes "group_past_event_count"

photo

Photo associated with group, returned when fields request parameter value includes 'group_photo'

photo_gradient

Color combination used to generate group duotone, returned when fields request parameter value includes 'group_photo_gradient'

pro_network

Information on group's Pro organization, returned when "fields" request parameter value includes "group_pro_network"

region

Language and region of the group

self

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'

state

State of the group

timezone

Timezone of group

topics

Topics related to the group, returned when fields request parameter value includes 'group_topics'

urlname

Alphanumeric urlname identifier for the group

visibility

Group visibility, returned when fields request parameter value includes 'group_visibility'. Value may be "public", "public_limited", or "members".

who

What the group calls its members

how_to_find_us

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'

id

A unique alphanumeric identifier for event

is_online_event

Is event happening online

link

Link to event on meetup.com

local_date

The local date of the Meetup in ISO 8601 format

local_time

The local time of the Meetup in ISO 8601 format

manual_attendance_count

Manually entered total attendee headcount, if any exists

name

Name of the event

past_event_count_inclusive

Number of past events that happened before and including this event. Returned when "fields" request parameter value contains "past_event_count_inclusive"

photo_album

Information about photo uploads for this event, returned when fields request parameter value includes 'photo_album'

event

Event photo album belongs to. This will be absent if the album is not associated with an event

id

Unique numeric identifier for photo album

photo_count

Number of photos uploaded

photo_sample

A small collection of photos uploaded for this event

title

Album title

plain_text_description

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_no_images_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"

rsvp_close_offset

The amount of time between when RSVPs close and the start time of the Meetup in ISO 8601 format

rsvp_limit

The number of "yes" RSVPS an event has capacity for

rsvp_open_offset

The amount of time between when RSVPs open and the start time of the Meetup in ISO 8601 format

rsvp_rules

Information about conditions that allow for member RSVPs, returned when fields request parameter value include 'rsvp_rules'

close_time

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

closed

Boolean value indicating whether or not RSVPing was explicitly closed for the event.

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

waitlisting

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

rsvp_sample

A small collection RSVPs for members attending this event, returned when fields request parameter value includes 'rsvp_sample'

created

Creation time of the RSVP, in milliseconds since the epoch

id

Unique numeric identifier for the RSVP. May be -1 for events scheduled in the future

member

Member who RSVP'd

updated

Last modified time of the RSVP, in milliseconds since the epoch

rsvpable

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"

rsvpable_after_join

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

saved

Whether the authorized member has saved the event, returned when fields request parameter value includes 'saved'

self

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'

actions

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

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'

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

series

Returned when the "fields" request parameter value includes "series" for events that are part of a series of events

description

Human displayable description of how often events in this series occur

end_date

Date when this series ends/ended, in milliseconds since the epoch

id

Unique numeric identifier for the series

monthly

Returned for events that are part of a monthly recurring series of events

start_date

Date when this series begins/began, in milliseconds since the epoch

template_event_id

Unique numeric identifier for the template event of the series

weekly

Returned for events that are part of a weekly recurring series of events

short_link

A shortened link for the event on meetup.com, returned when fields request parameter value includes "short_link"

simple_html_description

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

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

survey_questions

List of organizer-defined survey questions intended to be asked of RSVPing members. Returned when the "fields"' request parameter contains "answers"

id

Numeric question identifier

question

Question text

time

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

updated

Last modified time for the event in milliseconds since the epoch

utc_offset

The local offset from UTC time, in milliseconds

venue

The event venue, present only if selected and not hidden by an organizer

address_1

Line 1 of venue address

address_2

Line 2 of venue address

address_3

Line 3 of venue address

city

City of venue

country

Country code of venue

id

Unique numeric venue id

lat

Approximate latitude

localized_country_name

The localized name of the venue's country

lon

Approximate longitude

name

Venue name

phone

Phone number of venue

repinned

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

state

State of venue where available

zip

ZIP code if, venue is in US or Canada

venue_visibility

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

visibility

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.

waitlist_count

Number of members on the waitlist, if one exists

web_actions

Set of "Invite" and google/yahoo/ical/outlook "Add to calendar" web actions

why

We should do this because...

yes_rsvp_count

Number of yes RSVPs including guests

event_image

Description of event image

base_url

A base url that can be use to construct a photo url from its components

highres_link

Link for full sized photo

id

Numeric photo ID

photo_link

Link for standard sized photo

thumb_link

Link for thumbnail sized photo

type

Type of photo. One of "event" or "member"

API methods