Extend your community

Events

GET /events
  • json
  • rss
  • atom
  • xml
  • kml
Host: api.meetup.com
  • basic
api version 1

Deprecated: use /2/events

Deprecated API method for accessing meetup events. Please see /2/events and /2/open_events for replacements.

Try it in the console

Request Parameters

At least one of the required parameters must be supplied with the request. Location-based queries are deprecated. Use the /2/open_events API for location-based queries instead.

after

Return events that start after the specified date, formatted as either a relative date such as "-1w" for one week ago or by absolute time in milliseconds since the epoch. Relative dates are annotated using one of the following time intervals: "d" for day, "w" for week, or "m" for month. Defaults to today. See also status

before

Return events that started before the specified date, formatted as described by the "after" parameter. Defaults to after + 60 days. Limited to one year beyond the after date

fields

Request that additional fields (separated by commas) be included in the output. "photo_album_id" will include photo album info, and "waiting_rsvpcount" will include waitlist rsvp info in response items

group_id

Return events from groups with the specified IDs, separated by commas

group_urlname

Return events for the group with this custom URL path

id

Return events with the specified IDs, separated by commas. When id is supplied, the date and status parameters are by default unlimited so that all events with matching IDs will be returned

member_id

A member id number, limits results set to events in groups that the member specified by this id is currently a member of (excludes private groups, unless the member_id is the same as that of the member making the request)

rsvp_limit

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

status

Return events matching one of the given status values, separated by commas. Possible statuses are "upcoming", "autoscheduled", "proposed", "suggested", and "past". The default status parameter is "upcoming". If a date of today or earlier is specified for after, the default becomes "past,upcoming". Specifying a status of "autoscheduled" by itself, or in addition to others, will display events which have been created using the autoscheduling tool.

text_format

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

topic

Return events in the specified topic(s), one topic allowed

topic, groupnum

Return events for the group with given topic and number

Ordering

group

the name of the group having the event

location

group location, country, state [if present], city

time

event time

topic

the topic of the event

updated

event updated field

Response

allow_maybe_rsvp

Set to "1" if this meetup allows members to rsvp "Maybe", or

attendee_count

Number of attendees at the event

description

Description of the event, see text_format above

event_hosts

Members chosen to host this event, may include the organizer

member_id

Member ID of the event host

member_name

Name of the event host

fee

Fee for this event (or 0.0 if this event has no fee)

feecurrency

Currency of the fee for this event

feedesc

Fee description, or blank if this event has no fee

feelabel

Fee label, or blank if this event has no fee or fee label

guest_limit

Maximum number of guests that a member can RSVP for

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 ID of the event

ismeetup

Set to either a "1" or a "0" if this is a Meetup event or just a calendar note, respectively

lat, lon

Latitude and longitude coordinates of group location

maybe_rsvpcount

Number of "maybe" rsvps to this event, including guests

member_status

Set to "member" or "nonmember" if member is member of the group hosting the event

my_waitlist_status

The current waitlist status for this event of the user making the request (could be "waitlist" or blank)

myrsvp

The current RSVP status for this event of the user making the request (could be "yes","no","maybe", or "none")

name

The name (title) of the event

no_rsvpcount

Number of "no" rsvps to this event

organizer_id

Member ID of the organizer of this Meetup group

organizer_name

Name of the organizer of this Meetup group

photo_album_id

ID of photo album attached to this event, only supplied if fields contains "photo_album_id"

photo_count

Number of photos in an album associated with this event, only supplied if fields contains "photo_album_id"

photo_url

URL of the event photo

rating

The event's rating. If the event hasn't happened yet or there are no ratings submitted, this field will default to 0

rating_count

The number of ratings that have been submitted for the event. If the event hasn't happened yet or there are no ratings submitted, this field will default to 0

rsvpcount

Number of "yes" or "maybe" rsvps to this event, including guests.

short_link

Optional field. If hosting group is private, this will return the group's short_link

status

Description of the event, see text_format above

time

The date and time that the event will take place

updated

The last date and time that the event's information was modified

utc_rsvp_cutoff

The date and time that members can RSVP until, in milliseconds since the epoch

utc_rsvp_open_time

The date and time that members can begin to RSVP, in milliseconds since the epoch

utc_time

The date and time that the event will take place, in milliseconds since the epoch.

venue_address1

line 1 of venue address

venue_address2

line 2 of venue address

venue_city

city of venue

venue_id

ID of venue

venue_lat, venue_lon

the latitude and longitude of the venue

venue_map

URL of a map indicating the venue location

venue_name

name of venue

venue_phone

phone number of venue

venue_state

state of venue

venue_visibility

Set to "members" or "public". All other venue fields will be blank if the visibility is "members" and the current authenticated user is not a member of the group hosting the event.

venue_zip

zipcode of venue

waiting_rsvpcount

Number of waitlist rsvps to this event, including guests, only supplied if fields contains "waiting_rsvpcount"

API methods