addressalign-toparrow-leftarrow-leftarrow-right-10x10arrow-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
We've migrated to a new GraphQL framework!
Already have a token? Switching to GraphQL is easy with these migration instructions.
For new API users, learn more about the Meetup GraphQL API.
RESTful API support will stop in winter 2021.

Extend your community

Event Photos

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

Lists photos for a given event

Try it in the console

Request Parameters

A valid path parameter for :urlname and :event_id is required

desc

Controls directional order or listing. Default false

fields

A comma-delimited list of optional response fields. Currently supported values are "comment_count", "self" and "short_link"

page

Number of items to return per-page of results. Defaults to 200

Response

Returns a list of event photo objects

base_url

A base url that can be use to construct a photo url from its components

caption

Photo caption, if defined

comment_count

The number of comments posted about this photo. Returned when 'comment_count' is present in the 'fields' request parameter.

created

Time photo was uploaded, in milliseconds since the epoch

group

Group the photo is associated with." + "|Returned when 'group' is present " + "|in the 'fields' request parameter.

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

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"

localized_location

City/State or City/Country of the group

name

Name of the group

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

status

Status of the group

urlname

Urlname used to identify the group on meetup.com

who

What the group calls its members

highres_link

Link for full sized photo

id

Numeric photo ID

link

Link to photo on meetup.com

member

Member who uploaded the photo. If member has since left the group, this will return a member with an id of 0

bio

Intro of member

event_context

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

host

Boolean indicator for whether this member is a host for the event

id

Numeric member ID

name

Name of member

photo

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

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"

role

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

title

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

photo_album

Photo album the photo is associated with

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

title

Album title

photo_link

Link for standard sized photo

self

Context for the authenticated member. Returned when 'self' is present in the 'fields' request parameter and the authenticated is a member of the group the photo is associated with.

actions

List of actions the authenticated member may perform on this photo or its containing album, potentially one or more of the following

"comment" if member can comment on this photo

"delete" if the member can delete the photo

"edit" if the member can edit the photo details

"upload_photo" if the member can upload new photos

short_link

Shortened link to photo on meetup.com. Returned when 'short_link' is present in the 'fields' request parameter

thumb_link

Link for thumbnail sized photo

type

Type of photo. One of "event" or "member"

updated

Time photo was last updated, in milliseconds since the epoch

utc_offset

Numeric utc offset based on the timezone of the group hosting the event this photo was posted in

Event Photo Upload

POST /:urlname/events/:event_id/photos
  • json
Host: api.meetup.com
  • basic
api version 3

Support for uploading new Event photos

Request Parameters

A valid path parameter value for :urlname and :event_id is required

This method expects an HTTP POST containing a Content-Type of multipart/form-data. Only the photo parameter, which represents the photo being uploaded, is required.

Uploaded photos are fed into a separate photo staging process and may not be immediately available for display. To receive responses for photos that are immediately displayable, send the await request parameter with a value of true.

A maximum of 500 photos are allowed for a given event.

Authentication credentials should be omitted from the request body and be sent via HTTP Authorization header or as query string parameters

await

Optional boolean parameter that will defer a request's a response until confirmation that photo is immediately displayable is received.

caption

Caption for display. Max length 255

fields

A comma-delimited list of optional response fields. Currently supported values are "self" and "comment_count"

photo

Photo upload data, encoded as multipart/form-data. The maximum file size allowed is 10MB

Response

A successful request will respond with an Event Photo object If a successful photo upload is immediately accessible, a 201 Created status is returned, otherwise a 202 Accepted status is returned

base_url

A base url that can be use to construct a photo url from its components

caption

Photo caption, if defined

comment_count

The number of comments posted about this photo. Returned when 'comment_count' is present in the 'fields' request parameter.

created

Time photo was uploaded, in milliseconds since the epoch

group

Group the photo is associated with." + "|Returned when 'group' is present " + "|in the 'fields' request parameter.

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

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"

localized_location

City/State or City/Country of the group

name

Name of the group

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

status

Status of the group

urlname

Urlname used to identify the group on meetup.com

who

What the group calls its members

highres_link

Link for full sized photo

id

Numeric photo ID

link

Link to photo on meetup.com

member

Member who uploaded the photo. If member has since left the group, this will return a member with an id of 0

bio

Intro of member

event_context

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

host

Boolean indicator for whether this member is a host for the event

id

Numeric member ID

name

Name of member

photo

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

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"

role

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

title

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

photo_album

Photo album the photo is associated with

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

title

Album title

photo_link

Link for standard sized photo

self

Context for the authenticated member. Returned when 'self' is present in the 'fields' request parameter and the authenticated is a member of the group the photo is associated with.

actions

List of actions the authenticated member may perform on this photo or its containing album, potentially one or more of the following

"comment" if member can comment on this photo

"delete" if the member can delete the photo

"edit" if the member can edit the photo details

"upload_photo" if the member can upload new photos

short_link

Shortened link to photo on meetup.com. Returned when 'short_link' is present in the 'fields' request parameter

thumb_link

Link for thumbnail sized photo

type

Type of photo. One of "event" or "member"

updated

Time photo was last updated, in milliseconds since the epoch

utc_offset

Numeric utc offset based on the timezone of the group hosting the event this photo was posted in

Errors

caption_error

The provided caption was longer than 255 characters

photo_error

Returned photo was either omitted from the request or was invalid

upload_error

The process of uploading the photo failed

upload_limit_error

A member uploaded more photos than allowed for this event

upload_timeout_error

A awaited response timed out

API methods