Get Group

Try it in the console

Request Parameters

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

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

city

City of the group

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

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

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

intro_required

true if required, false otherwise

photo_required

true if required, false otherwise

questions

List of questions asked by organizer

id

Unique 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, open

lat

Latitude

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 fields parameter representing the policy for who can post the group mailing list. One of moderated, off, open, orgs_only

lon

Longitude

members

Number of Meetup members in this group

membership_dues

Optional field, returns membership dues for group if any

currency

Currency fee is declared as

fee

Numeric fee value

fee_desc

Description of fee

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. May be one of 'join' or 'rsvp'

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

Name of the group

next_event

The next upcoming event, if the group has one

id

Alphanumeric event ID

name

Name of event

time

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

organizer

Group's primary organizer

bio

Bio of member

id

Numeric member ID

name

Name of member

photos

A small set of photos from the group

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

self

Optional field, contains details specific to the authorized user if an active member of this group

actions

list of actions the current user 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, or "edit": the ability to edit group settings

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

Optional fields property returned when 'self_status' is provided. Indicates the authorized user's membership with this group. Value may be one of pending, pending_payment, active, blocked or none

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

id

Id of the group

join_mode

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

lat

Latitude

lon

Longitude

name

Name of the group

photos

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

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

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

state

State of the group, if in US or Canada

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

Request Parameters

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

intro_req

Indicates that a member must supply an introduction before joining. Expects true or false values

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

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 provide 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

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

city

City of the group

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

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

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

intro_required

true if required, false otherwise

photo_required

true if required, false otherwise

questions

List of questions asked by organizer

id

Unique 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, open

lat

Latitude

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 fields parameter representing the policy for who can post the group mailing list. One of moderated, off, open, orgs_only

lon

Longitude

members

Number of Meetup members in this group

membership_dues

Optional field, returns membership dues for group if any

currency

Currency fee is declared as

fee

Numeric fee value

fee_desc

Description of fee

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. May be one of 'join' or 'rsvp'

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

Name of the group

next_event

The next upcoming event, if the group has one

id

Alphanumeric event ID

name

Name of event

time

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

organizer

Group's primary organizer

bio

Bio of member

id

Numeric member ID

name

Name of member

photos

A small set of photos from the group

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

self

Optional field, contains details specific to the authorized user if an active member of this group

actions

list of actions the current user 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, or "edit": the ability to edit group settings

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

Optional fields property returned when 'self_status' is provided. Indicates the authorized user's membership with this group. Value may be one of pending, pending_payment, active, blocked or none

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

id

Id of the group

join_mode

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

lat

Latitude

lon

Longitude

name

Name of the group

photos

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

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

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

state

State of the group, if in US or Canada

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