Skip Main Navigation
Page Content

Ticket Groups

For returning developers, you may notice that many of our endpoints now start with the ‘/organizations/:organization_id/’ path. This is a result of changes we made in the first half of 2018 to support users associated with multiple organizations on Eventbrite. Please visit our Organizations page for further context on this change.

GET /ticket_groups/:ticket_group_id/

Returns the ticket_group with the specified :ticket_group_id.

Parameters

Takes no parameters

Errors

No endpoint-specific errors

DELETE /ticket_groups/:ticket_group_id/

Deletes the ticket_group with the specified :ticket_group_id. The status of the ticket group is changed to deleted.

Parameters

Takes no parameters

Errors

  • NOT_ALLOWED: Only tickets groups that are not associated with any ticket class may be deleted.

POST /ticket_groups/:ticket_group_id/

Updates the ticket group with the specified :ticket_group_id. Returns the updated ticket_group.

Parameters

Name Type Required Description
ticket_group.name string No Name of ticket group.
ticket_group.status string No The status of ticket group. Valid choices are: live, deleted, or archived.
ticket_group.event_ticket_ids dict No IDs of tickets by event id for this ticket group. In the format “{“event_id”: [“ticket_class_id”, “ticket_class_id”]}”.

Errors

No endpoint-specific errors

Argument Errors

  • ticket_group.name - DUPLICATE: The ticket group name provided is already in use.
  • ticket_group.status - INVALID: The ticket group status must be one of the options defined in ticket_group.

Example request

POST Update ticket group status only
https://www.eventbriteapi.com/v3/ticket_groups/:ticket_group_id/

JSON Data example:

{
    "ticket_group": {
        "status": "archived"
    }
}

Returns a ticket_group

GET /organizations/:id/ticket_groups/

Returns a paginated response of ticket_group for the specified organization.

To include the ticket class name and sales channel in the response, add the tickets expansion parameter.

Parameters

Name Type Required Description
status string No Limits results to groups with the specific status (Valid choices are: live, archived, deleted, or all)

Errors

No endpoint-specific errors

POST /organizations/:id/ticket_groups/

Creates a ticket group and returns the created ticket_group. Only up to 200 live ticket groups may be created; those with archived or deleted status are not taken into account.

Parameters

Name Type Required Description
ticket_group.name string Yes Name of ticket group.
ticket_group.status string No The status of ticket group. Valid choices are: live, deleted, or archived.
ticket_group.event_ticket_ids dict No IDs of tickets by event id for this ticket group. In the format “{“event_id”: [“ticket_class_id”, “ticket_class_id”]}”.

Errors

No endpoint-specific errors

Argument Errors

  • ticket_group.name - MISSING: The ticket group must have a name.
  • ticket_group.name - DUPLICATE: The ticket group name provided is already in use.

Example Request

POST Create ticket group
https://www.eventbriteapi.com/v3/organizations/12345/ticket_groups/

JSON Data example:

{
    "ticket_group": {
        "name": "summer",
        "event_ticket_ids": "{\"28744198672\": [\"56472627\", \"56472628\"]}"
    }
}

Returns a ticket_group

POST /organizations/:id/events/:event_id/ticket_classes/:ticket_class_id/ticket_groups/

Add the Ticket Class with the specified :ticket_class_id of the event with :event_id that belongs to the organization to many Ticket Groups specified with ticket_group_ids. If the list provided is empty, remove this ticket class from every ticket group.

Parameters

Name Type Required Description
ticket_group_ids list No IDs of all ticket group this ticket belongs to. If this is not passed will remove all ticket groups from the ticket.

Errors

No endpoint-specific errors

Example Request

POST Associate the ticket class to several ticket groups
https://www.eventbriteapi.com/v3/organizations/12345/events/:event_id/ticket_classes/:ticket_class_id/ticket_groups/

JSON Data example:

{
    "ticket_group_ids": ["11", "20"]
}
POST Remove all the associations that this ticket class have in every ticket group
https://www.eventbriteapi.com/v3/organizations/12345/events/:event_id/ticket_classes/:ticket_class_id/ticket_groups/

JSON Data example:

{
    "ticket_group_ids": []
}

POST /ticket_groups/

Please use POST /organizations/:id/ticket_groups/.

Warning

This endpoint is in the process of being deprecated.

Creates a ticket group and returns the created ticket_group. Only up to 200 live ticket groups may be created; those with archived or deleted status are not taken into account.

Parameters

Name Type Required Description
ticket_group.name string Yes Name of ticket group.
ticket_group.status string No The status of ticket group. Valid choices are: live, deleted, or archived.
ticket_group.event_ticket_ids dict No IDs of tickets by event id for this ticket group. In the format “{“event_id”: [“ticket_class_id”, “ticket_class_id”]}”.

Errors

No endpoint-specific errors

Argument Errors

  • ticket_group.name - MISSING: The ticket group must have a name.
  • ticket_group.name - DUPLICATE: The ticket group name provided is already in use.

Example Request

POST Create ticket group
https://www.eventbriteapi.com/v3/ticket_groups/

JSON Data example:

{
    "ticket_group": {
        "name": "summer",
        "event_ticket_ids": "{\"28744198672\": [\"56472627\", \"56472628\"]}"
    }
}

Returns a ticket_group

GET /users/:user_id/ticket_groups/

Please use GET /organizations/:id/ticket_groups/.

Warning

This endpoint is in the process of being deprecated.

Returns a paginated response of ticket_group for the specified user. The alias me (/users/me/) may be used to refer to the currently authenticated user.

To include the ticket class name and sales channel in the response, add the tickets expansion parameter: /users/me/?expand=tickets

Parameters

Name Type Required Description
status string No Limits results to groups with the specific status (Valid choices are: live, archived, deleted, or all)

Errors

No endpoint-specific errors

POST /users/:user_id/events/:event_id/ticket_classes/:ticket_class_id/ticket_groups/

Please use POST /organizations/:id/events/:event_id/ticket_classes/:ticket_class_id/ticket_groups/.

Warning

This endpoint is in the process of being deprecated.

Add the Ticket Class with the specified :ticket_class_id of the event with :event_id that belongs to the user with :user_id to many Ticket Groups specified with ticket_group_ids. If the list provided is empty, remove this ticket class from every ticket group.

Parameters

Name Type Required Description
ticket_group_ids list No IDs of all ticket group this ticket belongs to. If this is not passed will remove all ticket groups from the ticket.

Errors

No endpoint-specific errors

Example Request

POST Associate the ticket class to several ticket groups
https://www.eventbriteapi.com/v3/users/me/events/:event_id/ticket_classes/:ticket_class_id/ticket_groups/

JSON Data example:

{
    "ticket_group_ids": ["11", "20"]
}
POST Remove all the associations that this ticket class have in every ticket group
https://www.eventbriteapi.com/v3/users/me/events/:event_id/ticket_classes/:ticket_class_id/ticket_groups/

JSON Data example:

{
    "ticket_group_ids": []
}