addressalign-toparrow-leftarrow-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

Extend your community

Member Calendar

GET /self/calendar
  • json
Host: api.meetup.com
  • basic
api version 3

Get a listing of all upcoming Meetup events for the authenticated member

Try it in the console

Request Parameters

All parameters are optional.

This endpoint uses HTTP Link header based pagination

fields

A comma-delimited list of optional fields names which may be appended to the response

page

Number of results to return in a page. Defaults to 200

Response

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

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

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"

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

code

Currency accepted for fee

default

A boolean set to true if the currency is the group's default currency, false otherwise

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, wepay)

group

Information about group hosting the event

category

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

id

Numeric category id

name

Display name of the category

shortname

String identifier of the category

sort_name

Name used for sorting

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"

photo_req

true if required, false otherwise

questions

List of profile questions organizer would like new members to answer prior to joining

questions_req

true if required, false otherwise

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'

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"

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'

currency

Currency in which the fee is declared

fee

Numeric fee value

fee_desc

The interval at which dues must be paid. Possible values may include: "month", "year", "day", or "every other day"

methods

Methods of payments

reasons

Array of reasons containing one or more of 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

Conditions for refunds

required

true if dues are required

required_to

If the dues are required this indicates what they are required for. Currently may only be 'join'

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

meta_category

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

best_topics

Represents the best topic matches for this category, returned when the "fields" request parameter value includes "best_topics"

category_ids

List of numeric category ids associated with this topic category

id

Numeric topic-category id

name

Display name of the topic-category

photo

Photo representing this category

shortname

Unique string identifier for this category

sort_name

Name used for sorting

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'

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"

photo_gradient

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

composite_color

Composite color in hexidecimal format

dark_color

Dark color in hexidecimal format

id

Unique numeric identifier

light_color

Light color in hexidecimal format

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'

actions

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

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

profile

Profile of the authenticated member

status

Indicates the authorized user's membership with this group.

Value may be one of "none", "pending", "pending_payment", "active", or "blocked"

state

State of the group

timezone

Timezone of group

topics

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

id

Numeric topic id

lang

Language topic originates from

name

Display name of the topic

urlkey

The unique keyword used to identify this topic

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

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

Alphanumeric event ID

name

Name of event

no_rsvp_count

Number of no RSVPs, included if the rsvp_counts field is set

time

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

utc_offset

The local offset from UTC time, in milliseconds

waitlist_count

Number of waitlisted RSVPs, included if the rsvp_counts field is set

yes_rsvp_count

Number of yes RSVPs

id

Unique numeric identifier for photo album

photo_count

Number of photos uploaded

photo_sample

A small collection of photos uploaded for this event

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"

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

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'

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

bio

Intro of member

event_context

Member's context within the event. Only returned in the context of an event

id

Numeric member ID

name

Name of member

photo

Member photo, if available. Members who registered via Facebook may not have highres photos

role

The leadership role of this member within the group, if any. Value may be one of assistant_organizer, coorganizer, event_organizer, organizer

self

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

title

Organizer defined title of member. May be absent if not defined

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

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

guests

Number of guests the RSVP'd member will be bringing

response

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

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

day_of_week

Integer value between 1-7 (Monday-Sunday) for the day of week the recurrence occurs upon

interval

Integer number of months between each recurrence

week_of_month

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

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

days_of_week

List of integers 1-7 (Monday-Sunday) of days of week recurrence occurs upon

interval

Integer number of weeks between each recurrence

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

API methods

v3 batch

v2 categories

v2 cities

v2 dashboard

v1 groups

v1 oembed

v1 topics

v2 deprecated