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

Profiles

GET /2/profiles
  • json
  • xml
Host: api.meetup.com
  • basic
api version 2

This method returns member profiles associated with a particular group. Meetup members have separate profiles for each group they join.

Try it in the console

Request Parameters

At least one of the required parameter(s) must be supplied with the request. If any of the groups you specify are private, you will not see its members listed in the result set unless you are a member of that group. If querying for member_id alone, the member's 'hide groups' preference will be honored. 'Interesting' ordered searches only support searching by group_urlname or group_id. Only one of those may be supplied.

fields

comma delimited list of optional response properties. A value of "membership_dues" will populate membership dues for the authorized user or members of the groups the authorized user organizes

group_id

Return profiles in the group with this ID

group_urlname

Return profiles for the group with the given custom URL path

member_id

Return the profiles for members with these IDs, separated by commas

role

if "leads", only profiles for members of the leadership team are included

status

Status filter for members. Only organizers may see pending. Request must also contain a group_id or group_urlname. Status may be one of active, pending

topic, groupnum

Group identification by topic, deprecated

Ordering

interesting

Order which may be interesting to the authorized member

joined

time member joined this group

member_id

the id of the member

name

the name of the member

updated

profile updated field

visited

last visit to group pages (default order)

Response

additional

Additional information supplied by the member

answers

Array of answers to group profile questions. Unanswered questions are returned without the answer field

answer

Text of the answer if answered

question

Text of the question

question_id

Unique ID of the question this answers

bio

Member's 'introduction' to the group

comment

What this member says about this group

created, updated

When this member profile was created and last updated, in milliseconds since the epoch.

group

The group this profile belongs to

created

Date and time that the group was founded, in milliseconds since the epoch

group_lat

Approximate group latitude

group_lon

Approximate group longitude

id

Group id

join_mode

"open", "approval", or "closed"

name

Group name

urlname

Group URL name

who

What the group calls its members

member_city

Optional fields parameter for the Member's city

member_country

Optional fields parameter for the Member's country code

member_id

The member's id

member_state

Optional fields parameter for the Member's state (when country is us)

membership_dues

Optional fields parameter for the last payment received for the Group's membership dues and optionally, the status of the member's dues for the current billing period if the group has set up recurring membership dues payments. This field is only visible only to the organizer of the group and to the member themselves. Members can not see other member's 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.

days

The total number of trial days offered by the group

days_remaining

The number of days remaining in the member's trial period

expired

Boolean indicator of whether or not the unpaid subscription has expired or not

name

The member's name

other_services

Third-party services associated with the member account

[service-name]

This element is flickr, tumblr, twitter, or linkedin

identifier

identifier for the service, a username or URL

photo

The member's photo if available

highres_link

URL for the photo at its maximum size

photo_id

Photo ID

photo_link

URL for a standard size of the photo

thumb_link

URL for a thumbnail of the photo

photo_url

Link to the group profile photo of the member

profile_url

Link to the member's group profile page

role

If applicable, the member's role in the group (Organizer, Assistant Organizer, Co-organizer, or Event Organizer)

site_url, site_name

External site listed by the member

status

Value may be one of pending, active, blocked, pending_payment

title

Title assigned to the member in this group

visited

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

Examples

Return active member profiles in group 176399

https://api.meetup.com/2/profiles.json/?group_id=176399&key=ABDE12456AB2324445

API methods

v3 batch

v2 categories

v2 cities

v2 dashboard

v1 groups

v1 oembed

v1 topics

v2 deprecated