Name	Ticket Groups Index
Description	Lists all ticket groups for an event
Type	GET
URL	/v9/ticket_groups
Credential Type	API\|User
Supports Pagination	No

Ticket Groups / Index and Ticket Groups / Show are deprecated.

Use Listings / Index and Listings / Show instead.

Starting January 31, 2023 we will be redirecting requests to Listings but the response payload is different so it is recommended you update your applications accordingly.

Long Description

Returns all ticket groups for the given event_id. This endpoint does not support pagination—all ticket groups matching your query will be returned.

Most users will want to use both lightweight=true and ticket_list=false to achieve the fastest results.

Please review our information on placing Test Orders in our Sandbox environment.

Each Ticket Group in the response will include an available_ticket_count property, which indicates how many tickets are currently available to sell.

Seating Charts

Ticket Evolution’s dynamic seating charts are included and can be used via our Javascript client. Instructions are provided at that link.

When using our dynamic seating charts you will want to include include_tevo_section_mappings=true with your /ticket_groups request.

Parameters

Name	Description	Value Type	Required
`event_id`	ID of the Event for which you would like to list tickets	integer	Required
`show_past`	Include tickets for events in the past	boolean	Optional
`office_id`	Show only tickets owned by a specific office	integer	Optional
`type`	Filter by type to specify what types of tickets you will receive for an event: `event` `parking`	string	Optional
`quantity`	Filter by number of tickets greater than passed value	integer	Optional
`section`	Filter by exact match section	String	Optional
`row`	Filter by exact match row	String	Optional
`exclude_office_id`	Exclude tickets owned by a specific office	integer	Optional
`wheelchair`	Filter by wheelchair-accesssible tickets	boolean	Optional
`include_unavailable`	List all tickets (overrides default behavior of listing only available)	boolean	Optional
`order_by`	Sort results by any of the following parameters: `retail_price` `section` `row` `format` `available_count` `wheelchair` `in_hand` Adjust the sort direction by appending `ASC` or `DESC.` e.g.: `order_by=available_count+DESC`	String	Optional
`format`	Filter results to one or more specific ticket format(s): `Physical` `Eticket` `Flash_seats` `TM_mobile` `Paperless` To include multiple formats separate them by a comma. e.g.: `format=Physical,Eticket`	String	Optional.
`eticket`	~~Display only eTickets.~~ Deprecated. Use `format` instead	~~Boolean~~	~~Optional~~
`instant_delivery`	Display only tickets available for “Instant Delivery”. Only etickets are available for Instant Delivery.	boolean	Optional
`updated_at`	Filter by ticket updated at	Date	Optional
`state`	Filter by ticket state	string	Optional
`lightweight`	Return a significantly smaller response with less details for greater speed (Hint: You should almost always set this to true)	boolean	Optional, Default: false
`ticket_list`	Omits the seat-level detail from the response. (Hint: You should almost always set this to false)	boolean	Optional Default: false
`include_tevo_section_mappings`	When set to `true` results will include an additional parameter, `tevo_section_name`, which indicates the canonical section name to be used with ticketevolution/seatmaps-client. This should only be set to `true` if you are utilizing Ticket Evolution seat maps.	Boolean	Optional Default: false

Examples

Request Response

Example of a request using lightweight=true which is recommended for all requests to this endpoint
/v9/ticket_groups?event_id=1443642&include_tevo_section_mappings=true&lightweight=true&order_by=retail_price&type=event

Results from /ticket_groups

{
  "total_entries": 66,
  "ticket_groups": [
    {
      "id": 506945848,
      "url": "/ticket_groups/506945848",
      "type": "event",
      "row": "9",
      "section": "211",
      "quantity": 1,
      "available_quantity": 1,
      "wholesale_price": 251.32,
      "eticket": true,
      "instant_delivery": true,
      "intended_for_instant_delivery": false,
      "in_hand": true,
      "in_hand_on": null,
      "public_notes": null,
      "splits": [
        1
      ],
      "featured": false,
      "retail_price": 251.32,
      "format": "Eticket",
      "view_type": null,
      "broadcast": "t",
      "wheelchair": false,
      "signature": "Z1hGWlMrZ3A0UkhhNFhBaFdUSXpCOGFuMXZielhmT2hhVkxUMmhXQ1ZQND0tLVp5cW9WRzJqVm1pYVNxbm1iZ2tGUHc9PQ==--3c48da54088690d3d3bdbee4d039857219065bb1",
      "ticket_states": {
        "available": 1
      },
      "office": {
        "id": 1692,
        "url": "/offices/1692",
        "name": "Auto-Purchase",
        "brokerage": {
          "id": 1700,
          "url": "/brokerages/1700",
          "name": "Auto-Purchase",
          "abbreviation": "TEvo"
        }
      },
      "natb_member": false,
      "tevo_section_name": "middle level sideline 211"
    }

    …

  ]
}

Example of a request that does not request the lightweight results. This is NOT recommended.

/v9/ticket_groups?event_id=1443642&include_tevo_section_mappings=true&order_by=retail_price&type=event