addressalign-toparrow-leftarrow-rightbackbellblockcalendarcameraccwcheckchevron-downchevron-leftchevron-rightchevron-small-downchevron-small-leftchevron-small-rightchevron-small-upchevron-upcircle-with-checkcircle-with-crosscircle-with-pluscontroller-playcrossdots-three-verticaleditemptyheartexporteye-with-lineeyefacebookfolderfullheartglobe--smallglobegmailgooglegroupshelp-with-circleimageimagesinstagramFill 1launch-new-window--smalllight-bulblinklocation-pinm-swarmSearchmailmessagesminusmoremuplabelShape 3 + Rectangle 1ShapeoutlookpersonJoin Group on CardStartprice-ribbonprintShapeShapeShapeShapeImported LayersImported LayersImported Layersshieldstartickettrashtriangle-downtriangle-uptwitteruserwarningyahoo

Extend your community

Get Group

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

Fetches a Meetup group by urlname

Try it in the console

Request Parameters

Only the path parameter :urlname is required

fields

A comma-delimited list of optional fields to append to the response

Response

A successful response will include a representation of the group as a JSON object

approved

Boolean indicator for whether this Group has been approved or not. New Groups are generally approved (or removed) soon after creation. Returned when the "fields" request parameter value includes "approved"

category

The primary category of the group, if the group has one

id

Numeric category id

name

Display name of the category

shortname

String identifier of the category

sort_name

Name used for sorting

city

City of the group

city_link

Optional field, a URL for the group's city

contributions

Optional field containing the contribution details of the group

enabled

Boolean stating if contributions are enabled for the group

potential

Boolean stating that potential contributions are enabled for the group

reason

The reason a member might consider contributing

thanks

The 'thank you' message to be given when a contribution is made

country

Country of the group

created

Time the group was created in milliseconds since the epoch

description

Short description of group

discussion_count

The total number of the group's discussions. Returned when the 'fields' request parameter value contains 'discussion_count' and the group's 'visibility' setting permits it

discussion_sample

A small sampling of the group's discussions. Returned when the 'fields' request parameter value contains 'discussion_sample' and the group's 'visibility' setting permits it

created

long representing the time the discussion was created, measured by number of milliseconds from the Java epoch of 1970-01-01T00:00:00Z

creator

Member who created the discussion

bio

Member bio. When profile does not belong to the authenticated member, this may be omitted if member opted to hide their bio from others

birthday

Returned only when the fields request parameter value includes 'birthday' and only for the authenticated member when defined

city

City associated with Member's location

country

Country code associated with Member's location

email

Member email address. Provided only if a profile belongs to the authenticated member

gender

Returned only when the fields request parameter value includes "gender" and only for the authenticated member. Value may be one of "female", "male", "none", or "other". This field may be absent where gender is not defined

group_profile

Meetup Group profile information. This field is only returned when profile is requested in group contexts

id

Unique numeric identifier for the member

joined

Time member joined, represented as milliseconds since the epoch

lat

Geographic latitude associated with Member's location

localized_country_name

Name of country associated with Member's location

lon

Geographic longitude associated with Member's location

messaging_pref

The member's preference for being contacted from other members on the platform. Returned only when the fields request parameter value includes "messaging_pref". May be one of the following: "all_members", "groups_only", or "orgs_only"

name

Display name for the member

other_services

An object whose key's are the names of associated external networks and values are identities within those networks. The keys may be one of facebook, flickr, linkedin, tumblr or twitter. Returned only when "fields" request parameter value includes "other_services"

photo

Member photo. May be absent if member has not chosen one. In group contexts, the Member's Group profile photo will be returned.

privacy

Member's privacy preferences Returned only when the "fields" request parameter value includes "privacy"

self

Represents the authenticated member's relation to member. Returned when "fields" request parameter value includes "self" and the target member is not the authenticated member

state

State associated with Member's location, where available

status

a string with one of the following values: {'active', 'prereg', 'unknown'}

deleted

boolean representing whether the discussion is deleted

description

Content of the discussion

group

The Group associated with the discussion

created

long representing the time the group was created, measured by number of seconds from the Java epoch of 1970-01-01T00:00:00Z

id

integer representing unique group id

join_mode

string representing join mode of the group, which can be one of {open, approval, closed}

lat

float representing latitude of the group

lon

float representing longitude of the group

name

name of the group

urlname

Urlname used to identify the group

who

What the group calls its members

id

Unique string identifier of the discussion

like_count

an integer representing the number of likes for this discussion

num_comments

an integer representing the number of comments in this discussion

num_follows

an integer representing the number of follows in this discussion

report_link

string representing the url for reporting abuse on this discussion

self
actions

an array of strings that each represent an action the member is allowed to take on the discussion. Can include zero or more of the following: {Delete, FlagSpam, Comment, Follow, Unfollow, Like, Unlike}

followed

a boolean representing whether the member is following the discussion

updated

long representing the time the discussion was most recently modified, measured by number of milliseconds from the Java epoch of 1970-01-01T00:00:00Z

utc_offset

integer representing the utc time offset translated from meetup server time offset

visible

boolean representing whether the discussion is visible

event_sample

A small sampling of recent past events with photos. Returned when the "fields" request parameter value contains "event_sample" and the group's "visibility" setting permits it

created

Creation time of the event, in milliseconds since the epoch

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

fee

Ticketing fee information for events that support payments

accepts

Acceptable methods of payments may be one of "paypal", "amazon", "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

id

A unique alphanumeric identifier for event

local_date

The local date of the Meetup in ISO 8601 format

local_time

The local time of the Meetup in ISO 8601 format

name

Name of the event

photo_album

Information about photo uploads for this event

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

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_sample

A small collection RSVPs for members attending this event, returned when the "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

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

survey_questions

Contains a list of organizer-defined survey questions intended to be asked of RSVPing members. Returned when the "fields" request parameter contains "survey_questions"

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

waitlist_count

Number of members on the waitlist, if one exists

yes_rsvp_count

Number of yes RSVPs including guests

ga_code

Optional field return the Google Analytics code for the group. Only members that can edit group settings can see this

group_photo

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"

id

Numeric group ID

is_simplehtml

Optional field, 'true' when the group description has been saved in a simplified HTML format, 'false' otherwise.

join_info

Optional field, lists any questions requested when joining and required fields

photo_req

true if required, false otherwise

questions

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

id

Unique numeric identifier for the question

question

The text of the question

questions_req

true if required, false otherwise

join_mode

Who can join this group and how. One of "approval", "closed", or "open"

key_photo

Group primary 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"

last_event

Optional field representing the last hosted event, if the group has one. Returned when the "fields" request parameter value contains "last_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

lat

Latitude

leads

Optional field representing the number of members on this group's leadership team. Returned when the "fields" request parameter value contains "leads"

link

Link to group on meetup.com

list_addr

Optional field returning list address prefix. List mail will be {list_addr}-list@meetup.com. Announce email will be {list_addr}-announce@meetup.com. You must be a member of the group to see this

list_mode

Optional field representing the policy for who can post the group mailing list. Returned when the "fields" request parameter value contains "list_mode". Value may be one of "moderated", "off", "open", or "orgs_only"

localized_country_name

Name of country of the group

localized_location

City/State or City/Country of the group

lon

Longitude

member_cap

Number representing the maximum number of active members this group can have if capped. Returned only when requested in the fields request parameter and the authenticated member has permission to approve members

member_sample

A small sampling of active members. Returned when the 'fields' request parameter value contains 'member_sample' and the group's 'visibility' setting permits it

bio

Member bio. When profile does not belong to the authenticated member, this may be omitted if member opted to hide their bio from others

birthday

Returned only when the fields request parameter value includes 'birthday' and only for the authenticated member when defined

day

Numeric day member was born. May be absent if not defined

month

Numeric month member was born. May be absent if not defined

year

Year member was born

city

City associated with Member's location

country

Country code associated with Member's location

email

Member email address. Provided only if a profile belongs to the authenticated member

gender

Returned only when the fields request parameter value includes "gender" and only for the authenticated member. Value may be one of "female", "male", "none", or "other". This field may be absent where gender is not defined

id

Unique numeric identifier for the member

joined

Time member joined, represented as milliseconds since the epoch

lat

Geographic latitude associated with Member's location

localized_country_name

Name of country associated with Member's location

lon

Geographic longitude associated with Member's location

messaging_pref

The member's preference for being contacted from other members on the platform. Returned only when the fields request parameter value includes "messaging_pref". May be one of the following: "all_members", "groups_only", or "orgs_only"

name

Display name for the member

other_services

An object whose key's are the names of associated external networks and values are identities within those networks. The keys may be one of facebook, flickr, linkedin, tumblr or twitter. Returned only when "fields" request parameter value includes "other_services"

identifier

A unique string identifier

url

A url for this identity. May be the same as identifier in some cases

photo

Member photo. May be absent if member has not chosen one. In group contexts, the Member's Group profile photo will be returned.

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"

privacy

Member's privacy preferences Returned only when the "fields" request parameter value includes "privacy"

bio

may be 'hidden' or 'visible'

facebook

may be 'hidden' of 'visible'. If absent, the member has not connected their Facebook account to Meetup

groups

may be 'hidden' or 'visible

topics

may be 'hidden' or 'visible'

self

Represents the authenticated member's relation to member. Returned when "fields" request parameter value includes "self" and the target member is not the authenticated member

actions

List of actions available for the authenticated member to perform. Currently only "message" is supported

blocks

Boolean indication of whether or not the authenticated member blocks this member

common

Information the authenticated member has in common with this member

friends

Boolean indication of whether or not the authenticated member is a friend of the member

state

State associated with Member's location, where available

status

a string with one of the following values: {'active', 'prereg', 'unknown'}

members

Number of Meetup members in this group

membership_dues

Optional field, returns membership dues for group if any

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

amazon_payments

Boolean indicator that Amazon Payments are accepted

credit_card

Boolean indicator that credit cards are accepted

other

Boolean indicator that other forms of payment are accepted

paypal

Boolean indicator that Paypal payments are accepted

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

custom

Boolean indicator of a custom refund policy

group_closes

refund applies when the group closes

member_banned

refund applies when the member is banned

member_leaves

refund applies when member leaves the group

none

indicates there is no refund policy

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

best_topics

Represents the best topic matches for this category, returned when the "fields" request parameter value includes "best_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

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

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"

shortname

Unique string identifier for this category

sort_name

Name used for sorting

name

Name of the group

next_event

The current ongoing or next upcoming event, if one is scheduled

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

nominated_member

True if the member was nominated for the most recent handover and has not declined the nomination, false otherwise

nomination_acceptable

True if the group currently allows nominees to accept their handover nomination, false otherwise

organizer

Group's primary organizer

bio

Bio of member

id

Numeric member ID

name

Name of member

photo

Organizer photo, where defined

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"

pending_members

Number representing the count of members pending organizer approval to join. Returned only when requested in the fields request parameter and the authenticated member has permission to approve members

photo_gradient

Color combination used generate group duotone

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

photos

A small set of photos from the group

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"

plain_text_description

Description of the group, in plain text format. Returned when then "fields" request parameter value contains "plain_text_description"

plain_text_no_images_description

Description of the group, in plain text format with no images. Returned when then "fields" request parameter value contains "plain_text_no_images_description"

self

Optional field, contains details specific to the authorized user in this Meetup Group

actions

List of actions the authenticated member may perform, potentially "broadcast_message": the ability to broadcast messages to group members via the "announce" mailing list, "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

Member's membership dues if the group has membership dues

cancelled

For groups with recurring billing periods, this Boolean field indicates that membership dues were cancelled

exempt

For groups with recurring billing periods, this Boolean field indicates that the member is exempt from payment.

paid_until

For groups with recurring billing periods, this returns the time in milliseconds since the epoch that the member's next payment is due

period_status

For groups with recurring billing periods, this returns one of the following values grace paid pending unpaid

total_amount

Total amount paid

transaction_time

Time the transaction was made in milliseconds since the epoch

trial

If the group offers a trial membership, this indicates information for unpaid members.

role

Member's role in group, if any: Organizer, Assistant Organizer, Event Organizer, etc.

status

Indicates the authorized user's membership with this group. Value may be one of "none", "pending", "pending_payment", "active", or "blocked"

visited

Member's last visit to the group site, in milliseconds since the epoch

short_link

Optional field, a shorted URL for the group

similar_groups

Optional fields parameter. Returns up to 5 groups similar to this groups, best suited for the authenticated member when a single group is queried for. Note: this field is being deprecated in favor of making a separate request to /:urlname/similar_groups

id

Id of the group

join_mode

Who can join this group and how. One of "approval", "closed", or "open"

lat

Latitude

lon

Longitude

name

Name of the group

photos

Optional fields parameter. A small set of photos from the group

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"

urlname

Urlname used to identify the group on meetup.com

who

What this group calls it's members

simple_html_description

Description of the group, in simple HTML source format. If this group'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 value contains "simple_html_description"

state

State of the group, if in US or Canada

status

Status of the group

timezone

This represents the universal timezone identifier for the group

topics

Optional fields parameter. Returns the group's 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

Urlname used to identify the group on meetup.com

visibility

Who can see this group. One of members, public or public_limited

welcome_message

Optional fields parameter. Returns the Group's default welcome message if the authenticated member is the organizer of the group

who

What the group calls its members

Group Edit

POST /:urlname
  • json
Host: api.meetup.com
  • group_edit
api version 3

Allows organizers to edit their Meetup group information. To change group topics, see the add and remove topics endpoints. To change group photo use the Group photo upload endpoint. OAuth authenticated requests require an additional group_edit permission.

Request Parameters

All parameters are optional.

add_topics

Comma-delimited list of topic ids to associate with group

country

The ISO_3166-1 country code for the country which contains the city

description

Summary of what the Meetup group is about in simple HTML format

dryrun

Boolean parameter that will cause this endpoint to apply all validation rules without actually saving changes in which case the response will only reflect the group's current attributes

ga_code

Google Analytics code for group

join_mode

Controls how member's are let into the group. May be one of 'open' meaning any Meetup member my join, 'closed' meaning group is not currently accepting new members, or 'approval' meaning members must be approved by an organizer. Note, the 'closed' options is only available to groups that already have a 'closed' join_mode

key_photo

Group's primary photo. Must be ID of an existing album photo

list_addr

Mailing list prefix. By default this is the group's urlname.

list_mode

Defines policy for who can post to the group mailing list. May be one of 'open' meaning any member can post, 'off' meaning no one can post, 'moderated' meaning messages must be approved, or 'orgs_only' meaning only organizers may post to the list

name

Display name of the group. Can be at most 60 characters

photo_req

Indicates that a member must provide a photo before joining. Expects true or false values

question_edit_{id}

Edits a current profile question identified by an id in the parameter name. The index updated index should also be encoded in the parameter name. To delete a question, set this to an empty string. Groups that require profile questions must have at least one question

question_{index}

A new profile question defined in the order of index provided in the request parameter name

questions_req

Indicates that provided questions are required before joining. Expects true or false values

remove_topics

Comma-delimited list of topic ids to disassociate with group

urlname

Name used for the groups web address on meetup.com. Must be between 6 and 60 characters

visibility

Restricts group visibility for non-members. May be one of 'public', 'public_limited' or 'members'. Note, the 'members' option is only available to groups that already have 'members' visibility

welcome_message

Message sent to members after they join. Can be at most 2000 characters

who

What members of the group will be called. Can be at most 32 characters

zip

The ZIP code of the city

{service}_uri

A URI for a social network service. Service must be one of facebook, flickr, linkedin, other, tumblr, twitter

Response

A successful response will include a representation of the updated group as a JSON object

approved

Boolean indicator for whether this Group has been approved or not. New Groups are generally approved (or removed) soon after creation. Returned when the "fields" request parameter value includes "approved"

category

The primary category of the group, if the group has one

id

Numeric category id

name

Display name of the category

shortname

String identifier of the category

sort_name

Name used for sorting

city

City of the group

city_link

Optional field, a URL for the group's city

contributions

Optional field containing the contribution details of the group

enabled

Boolean stating if contributions are enabled for the group

potential

Boolean stating that potential contributions are enabled for the group

reason

The reason a member might consider contributing

thanks

The 'thank you' message to be given when a contribution is made

country

Country of the group

created

Time the group was created in milliseconds since the epoch

description

Short description of group

ga_code

Optional field return the Google Analytics code for the group. Only members that can edit group settings can see this

group_photo

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"

id

Numeric group ID

is_simplehtml

Optional field, 'true' when the group description has been saved in a simplified HTML format, 'false' otherwise.

join_info

Optional field, lists any questions requested when joining and required fields

photo_req

true if required, false otherwise

questions

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

id

Unique numeric identifier for the question

question

The text of the question

questions_req

true if required, false otherwise

join_mode

Who can join this group and how. One of "approval", "closed", or "open"

key_photo

Group primary 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"

last_event

Optional field representing the last hosted event, if the group has one. Returned when the "fields" request parameter value contains "last_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

lat

Latitude

leads

Optional field representing the number of members on this group's leadership team. Returned when the "fields" request parameter value contains "leads"

link

Link to group on meetup.com

list_addr

Optional field returning list address prefix. List mail will be {list_addr}-list@meetup.com. Announce email will be {list_addr}-announce@meetup.com. You must be a member of the group to see this

list_mode

Optional field representing the policy for who can post the group mailing list. Returned when the "fields" request parameter value contains "list_mode". Value may be one of "moderated", "off", "open", or "orgs_only"

localized_country_name

Name of country of the group

localized_location

City/State or City/Country of the group

lon

Longitude

member_cap

Number representing the maximum number of active members this group can have if capped. Returned only when requested in the fields request parameter and the authenticated member has permission to approve members

members

Number of Meetup members in this group

membership_dues

Optional field, returns membership dues for group if any

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

amazon_payments

Boolean indicator that Amazon Payments are accepted

credit_card

Boolean indicator that credit cards are accepted

other

Boolean indicator that other forms of payment are accepted

paypal

Boolean indicator that Paypal payments are accepted

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

custom

Boolean indicator of a custom refund policy

group_closes

refund applies when the group closes

member_banned

refund applies when the member is banned

member_leaves

refund applies when member leaves the group

none

indicates there is no refund policy

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

best_topics

Represents the best topic matches for this category, returned when the "fields" request parameter value includes "best_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

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

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"

shortname

Unique string identifier for this category

sort_name

Name used for sorting

name

Name of the group

next_event

The current ongoing or next upcoming event, if one is scheduled

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

nominated_member

Optional fields parameter. Returns if the logged in member has been nominated to take over the group.

organizer

Group's primary organizer

bio

Bio of member

id

Numeric member ID

name

Name of member

photo

Organizer photo, where defined

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"

pending_members

Number representing the count of members pending organizer approval to join. Returned only when requested in the fields request parameter and the authenticated member has permission to approve members

photo_gradient

Color combination used generate group duotone

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

photos

A small set of photos from the group

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"

plain_text_description

Description of the group, in plain text format. Returned when then "fields" request parameter value contains "plain_text_description"

plain_text_no_images_description

Description of the group, in plain text format with no images. Returned when then "fields" request parameter value contains "plain_text_no_images_description"

self

Optional field, contains details specific to the authorized user in this Meetup Group

actions

List of actions the authenticated member may perform, potentially "broadcast_message": the ability to broadcast messages to group members via the "announce" mailing list, "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

Member's membership dues if the group has membership dues

cancelled

For groups with recurring billing periods, this Boolean field indicates that membership dues were cancelled

exempt

For groups with recurring billing periods, this Boolean field indicates that the member is exempt from payment.

paid_until

For groups with recurring billing periods, this returns the time in milliseconds since the epoch that the member's next payment is due

period_status

For groups with recurring billing periods, this returns one of the following values grace paid pending unpaid

total_amount

Total amount paid

transaction_time

Time the transaction was made in milliseconds since the epoch

trial

If the group offers a trial membership, this indicates information for unpaid members.

role

Member's role in group, if any: Organizer, Assistant Organizer, Event Organizer, etc.

status

Indicates the authorized user's membership with this group. Value may be one of "none", "pending", "pending_payment", "active", or "blocked"

visited

Member's last visit to the group site, in milliseconds since the epoch

short_link

Optional field, a shorted URL for the group

similar_groups

Optional fields parameter. Returns up to 5 groups similar to this groups, best suited for the authenticated member when a single group is queried for. Note: this field is being deprecated in favor of making a separate request to /:urlname/similar_groups

id

Id of the group

join_mode

Who can join this group and how. One of "approval", "closed", or "open"

lat

Latitude

lon

Longitude

name

Name of the group

photos

Optional fields parameter. A small set of photos from the group

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"

urlname

Urlname used to identify the group on meetup.com

who

What this group calls it's members

simple_html_description

Description of the group, in simple HTML source format. If this group'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 value contains "simple_html_description"

state

State of the group, if in US or Canada

status

Status of the group

timezone

This represents the universal timezone identifier for the group

topics

Optional fields parameter. Returns the group's 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

Urlname used to identify the group on meetup.com

visibility

Who can see this group. One of members, public or public_limited

welcome_message

Optional fields parameter. Returns the Group's default welcome message if the authenticated member is the organizer of the group

who

What the group calls its members

API methods

v3 batch

v2 categories

v2 cities

v2 dashboard

v1 groups

v1 oembed

v1 topics

v2 deprecated