The group's events, earliest first
const url = 'https://app.grouperly.com/api/v2/groups/example/events?limit=50&status=DRAFT';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://app.grouperly.com/api/v2/groups/example/events?limit=50&status=DRAFT' \ --header 'Authorization: Bearer <token>'Events with no start time come last. Every status is included, as members see them in Grouperly.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”The credential’s group
Query Parameters
Section titled “Query Parameters”Items per page
From the previous page’s nextCursor; opaque
Only events with this status (case-insensitive)
Only events starting at or after this time (leaves out undated events)
Only events starting before this time (leaves out undated events)
Comma-separated related data to add: rsvpCounts, ticketTypes, leaders. Anything else is a 400.
Responses
Section titled “Responses”OK
object
object
E.g. “2026” for a yearly series
IANA zone, e.g. “America/Chicago”
object
object
A place counts only once it is paid for, or while its checkout is open (added in 2.12.0)
The subgroups that run it, apart from who it’s for: an event team runs Summer Camp, which is for the whole troop. Their leaders, and whoever holds a role there that runs its events, lead it as its own subgroup’s do; a role that only sees its events sees its attendees and payments. Empty for none (added in 2.35.0).
object
E.g. “Summer Camp”
Present only with include=rsvpCounts.
object
Responses that said Going (households, not people)
People on Going and Maybe responses. A response with no attendee rows counts as the responder plus its guest count (since 2.9.0; it counted 0 before).
People on Going responses: what the event’s capacity counts (added in 2.9.0)
People on Maybe responses (added in 2.9.0)
People on Going responses with a price who are paid for (added in 2.11.0)
People on Going responses whose checkout is holding their place (added in 2.11.0)
People on Going responses still owed for, in full or in part (added in 2.11.0)
People on Going responses with a place when payment is required to hold one: paid for, in checkout, or free with nothing owed on their response (added in 2.12.0)
Present only with include=ticketTypes.
object
object
A decimal string, e.g. “25.00”: never a float.
ISO 4217, e.g. “USD”.
Who leads the event: whoever holds its organizer or lead role, then the leaders of its subgroup and of each subgroup that runs it (2.35.0). Always on one event; on the list with include=leaders. A leader who may be a youth is left out without roster.youth.read (added in 2.18.0).
object
Their roster entry in the event’s group, as on RSVP attendees; null if they have none
The roster’s name, else the account’s
ORGANIZER or LEAD: an event role, given in Grouperly. SUBGROUP_LEADER (CIRCLE_LEADER before 2.28.0): a leader of the event’s subgroup, through a roster entry linked to their account. Someone holding two is listed for each. More may be added: treat one you don’t know as a leader.
The signed-in person’s relation to the event. Only for an app’s access token; a group key isn’t a person (added in 2.18.0).
object
The signed-in person is one of the event’s leaders: they hold its organizer or lead role, or lead its subgroup or one that runs it (2.35.0), or hold a role there that runs its events. The group’s owners and admins aren’t, unless they hold one of those roles (their access is on /me/groups).
The group’s custom fields on the event that the caller may see (GET /field-definitions?entity=EVENT), by key, null where one isn’t set: a key, whoever runs the group’s events and those leading the event see every one, anyone else those the whole group sees. On GET /events and /events/{eventId} (added in 2.37.0).
object
Pass as ?cursor= for the next page; null on the last page.
Example
{ "items": [ { "status": "DRAFT" } ]}Headers
Section titled “Headers”Requests allowed per minute for this credential
Requests left in this window
When the window ends (Unix seconds)
A query parameter is malformed or unknown (invalid_parameter, with parameter)
object
object
Stable and machine-readable: unauthorized, forbidden, insufficient_scope, key_owner_not_leader, app_not_installed, scope_not_allowed, app_suspended, rate_limited, not_found, invalid_parameter, invalid_body, invalid_profile, invalid_descriptor, no_profile, already_exists, not_a_member, wrong_holder, role_inactive, role_full, already_assigned, assignment_ended, version_not_current, nothing_to_pay, payments_not_ready, payload_too_large, first_party_only, terms_required, child_account, assistant_off, not_for_assistant, assistant_failed, not_a_draft, storage_full, made_from_roles, type_removed, invalid_reporting, led_by_role, unavailable, internal_error. New codes may be added.
For people; wording may change.
The query parameter (invalid_parameter) or body field (invalid_body, not_a_member, wrong_holder, invalid_reporting) at fault.
Examplegenerated
{ "error": { "code": "example", "message": "example", "parameter": "example" }}Headers
Section titled “Headers”Requests allowed per minute for this credential
Requests left in this window
When the window ends (Unix seconds)
Missing, unknown, revoked or expired credential (unauthorized)
object
object
Stable and machine-readable: unauthorized, forbidden, insufficient_scope, key_owner_not_leader, app_not_installed, scope_not_allowed, app_suspended, rate_limited, not_found, invalid_parameter, invalid_body, invalid_profile, invalid_descriptor, no_profile, already_exists, not_a_member, wrong_holder, role_inactive, role_full, already_assigned, assignment_ended, version_not_current, nothing_to_pay, payments_not_ready, payload_too_large, first_party_only, terms_required, child_account, assistant_off, not_for_assistant, assistant_failed, not_a_draft, storage_full, made_from_roles, type_removed, invalid_reporting, led_by_role, unavailable, internal_error. New codes may be added.
For people; wording may change.
The query parameter (invalid_parameter) or body field (invalid_body, not_a_member, wrong_holder, invalid_reporting) at fault.
Examplegenerated
{ "error": { "code": "example", "message": "example", "parameter": "example" }}A key: wrong group (forbidden), missing scope (insufficient_scope), or its creator no longer leads the group (key_owner_not_leader). An app’s token: missing scope (insufficient_scope), the group hasn’t installed the app (app_not_installed) or allowed the scope (scope_not_allowed, the message has the consent link), the person may not do this in the group (forbidden), Grouperly paused the app (app_suspended), the person hasn’t accepted Grouperly’s current Terms (terms_required: refresh their token, then send them to the hub’s /account/welcome), or it’s a child’s account (child_account). A viewer token: the same, and forbidden in any group but its own
object
object
Stable and machine-readable: unauthorized, forbidden, insufficient_scope, key_owner_not_leader, app_not_installed, scope_not_allowed, app_suspended, rate_limited, not_found, invalid_parameter, invalid_body, invalid_profile, invalid_descriptor, no_profile, already_exists, not_a_member, wrong_holder, role_inactive, role_full, already_assigned, assignment_ended, version_not_current, nothing_to_pay, payments_not_ready, payload_too_large, first_party_only, terms_required, child_account, assistant_off, not_for_assistant, assistant_failed, not_a_draft, storage_full, made_from_roles, type_removed, invalid_reporting, led_by_role, unavailable, internal_error. New codes may be added.
For people; wording may change.
The query parameter (invalid_parameter) or body field (invalid_body, not_a_member, wrong_holder, invalid_reporting) at fault.
Examplegenerated
{ "error": { "code": "example", "message": "example", "parameter": "example" }}Headers
Section titled “Headers”Requests allowed per minute for this credential
Requests left in this window
When the window ends (Unix seconds)
Rate limited (rate_limited)
object
object
Stable and machine-readable: unauthorized, forbidden, insufficient_scope, key_owner_not_leader, app_not_installed, scope_not_allowed, app_suspended, rate_limited, not_found, invalid_parameter, invalid_body, invalid_profile, invalid_descriptor, no_profile, already_exists, not_a_member, wrong_holder, role_inactive, role_full, already_assigned, assignment_ended, version_not_current, nothing_to_pay, payments_not_ready, payload_too_large, first_party_only, terms_required, child_account, assistant_off, not_for_assistant, assistant_failed, not_a_draft, storage_full, made_from_roles, type_removed, invalid_reporting, led_by_role, unavailable, internal_error. New codes may be added.
For people; wording may change.
The query parameter (invalid_parameter) or body field (invalid_body, not_a_member, wrong_holder, invalid_reporting) at fault.
Examplegenerated
{ "error": { "code": "example", "message": "example", "parameter": "example" }}Headers
Section titled “Headers”Requests allowed per minute for this credential
Requests left in this window
When the window ends (Unix seconds)
Seconds to wait
An app’s token for someone new, while Grouperly’s sign-in can’t be reached (unavailable); try again
object
object
Stable and machine-readable: unauthorized, forbidden, insufficient_scope, key_owner_not_leader, app_not_installed, scope_not_allowed, app_suspended, rate_limited, not_found, invalid_parameter, invalid_body, invalid_profile, invalid_descriptor, no_profile, already_exists, not_a_member, wrong_holder, role_inactive, role_full, already_assigned, assignment_ended, version_not_current, nothing_to_pay, payments_not_ready, payload_too_large, first_party_only, terms_required, child_account, assistant_off, not_for_assistant, assistant_failed, not_a_draft, storage_full, made_from_roles, type_removed, invalid_reporting, led_by_role, unavailable, internal_error. New codes may be added.
For people; wording may change.
The query parameter (invalid_parameter) or body field (invalid_body, not_a_member, wrong_holder, invalid_reporting) at fault.
Examplegenerated
{ "error": { "code": "example", "message": "example", "parameter": "example" }}