View Source

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

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.

If you are testing in the Sandbox the events named "Test Event" is recommended as it they several large ticket groups of various types and statuses.

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

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: `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` `Guest_list` (no actual ticket) `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

{
  "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

{
  "total_entries": 66,
  "ticket_groups": [
    {
      "tevo_section_name": "Middle Level Sideline 211"
      "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,
      "remote_id": null,
      "public_notes": null,
      "private_notes": null,
      "exchange_notes": null,
      "created_at": "2018-09-06T19:00:32Z",
      "updated_at": "2018-11-02T00:30:20Z",
      "splits": [
        1
      ],
      "ticket_states": {
        "available": 1
      },
      "ticket_hold_ids": [
        "NULL"
      ],
      "seats": [],
      "tickets": [
        [
          "available",
          "NULL"
        ]
      ],
      "has_spec_tickets": false,
      "featured": false,
      "retail_price": 251.32,
      "format": "Eticket",
      "face_value": null,
      "view_type": null,
      "broadcast": "t",
      "wheelchair": false,
      "evopay_discount": 0,
      "evopay_discount_price": 218.54,
      "ticket_costs": [
        null
      ],
      "ticket_purchase_order_ids": [
        null
      ],
      "freshness": "> 240 mins",
      "signature": "Z1lBNnJ2ODJCbWpVQjN4cS9Zd3pIUk5vc2Z6WHBHZWNHRVRYM1F4MW55bz0tLXhlMlhrTjBMWVRVcWJLUlZzUUR0VUE9PQ==--4cc7f77a65a5410cc88a26f2037d8b4196772256",
      "event": {
        "id": 1443642,
        "url": "/events/1443642",
        "name": "Fleetwood Mac",
        "occurs_at": "2019-03-11T20:00:00Z"
      },
      "office": {
        "id": 1692,
        "url": "/offices/1692",
        "name": "Auto-Purchase",
        "brokerage": {
          "id": 1700,
          "url": "/brokerages/1700",
          "name": "Auto-Purchase",
          "abbreviation": "TEvo Seller"
        }
      },
      "natb_member": false
    },

    …

  ]
}