Ticket Groups
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.
Ticket Group Properties:
Properties not listed in the table below can be safely ignored.
| Property | Details |
|---|---|
| id | Unique identifier for ticket_group. |
| type | Either event or parking to indicate which type of ticket this is. parking tickets do not include admission to the event but are great add-on item to suggest to a visitor purchasing event tickets |
| section | Indicates where seats are located. Tickets without assigned locations are usually labeled as "GA" or "General Admission" or "Gen Adm." Tickets that have no actual seat are usually labeled as "SRO" or "Standing Room Only." |
| row | See section. |
| available_quantity | This is how many total tickets are available from this ticket group. |
| splits | An array of the quantities that may be purchased from this ticket group. Orders for quantities that are not in this array may be rejected. If you are building a <select> element for the user to choose the quantity they wish to buy you should populate the <options> with these values. |
| wholesale_price | This is your cost for each ticket from this ticket group. When you submit an order the price you submit must be at least this much or the order will error. If you need to sell tickets below your cost you should use the discount parameter when placing your order. |
| retail_price | This is wholesale_price with any inventory rules applied. you are not required to charge your customer this amount. If you wish to handle retail price calculation on your side you may. |
| expected_delivery_type | This explains how it is expected that the ticket will be delivered to the Client. See the table below for more details. |
| format | Indicator of the format of the ticket. One of: Paperless, GuestList, FlashSeats, TMMobile, Flash_seats. |
| in_hand and in_hand_date | in_hand is a boolean property that indicates if the Seller has the tickets in their possession and can initiate the delivery process now. Since many sports teams announce their schedules before they deliver tickets to their season ticket holders the Sellers may have purchased the tickets but not yet received them from the team. Similarly, tickets for some other events may be sold but not yet delivered. If in_hand is false then in_hand_date will be the date on which the Seller expects to be able to initiate the delivery process. |
| instant_delivery | A boolean value that indicates whether or not you can expect these tickets to be available to your Client within a few minutes of placing the order. Only Ticket Groups with an expected_delivery_type of FILE_DOWNLOAD can be Instant Delivery. |
| public_notes | These notes should be displayed to the Client before purchasing and may include important details that may influence the buying decision. |
| featured | A boolean property used to indicate if a ticket group is considered to be “featured” based upon rules you provide. |
| wheelchair | A boolean property used to indicate if the tickets are marked as intended to be used by wheelchair or otherwise handicapped patrons. |
| view_type | One of: Full, Obstructed, Possibly Obstructed, or Partially Obstructed |
Ticket Groups / Index
Request to /ticket_groups?event_id=1074357 using cURL:
curl -i \
-X GET \
-H "X-Signature: aUIDfd+u7mA9xp7iGbY6xIx7ZOGD0Qcb99bDkMKwtgY=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/ticket_groups?event_id=1074357&lightweight=true'
Example JSON Response
{
"total_entries": 86,
"ticket_groups": [{
"id": 364697812,
"url": "/ticket_groups/364697812",
"type": "parking",
"row": "GA0",
"section": "VALET",
"quantity": 1,
"available_quantity": 1,
"wholesale_price": 12.0,
"eticket": true,
"instant_delivery": false,
"intended_for_instant_delivery": false,
"in_hand": true,
"in_hand_on": null,
"public_notes": "Parking Only",
"splits": [1],
"featured": false,
"retail_price": 12.0,
"format": "Eticket",
"view_type": null,
"broadcast": "t",
"wheelchair": false,
"signature": "RjIvR3BJNEFiQ01iY1BLYnlwdWhzK2tXTnRGS0NYTEZWQzJISXpEM2FyST0tLVEwTzdMMXZDS0h1SEduMzJ6d29ib1E9PQ==--37ffa61344fcad1c5d6acc530c95c352d544481b",
"ticket_states": {
"available": 1
},
"office": {
"id": 1692,
"url": "/offices/1692",
"name": "Auto-Purchase",
"brokerage": {
"id": 1700,
"url": "/brokerages/1700",
"name": "Auto-Purchase",
"abbreviation": "TEvo Seller"
}
}
}, {
"id": 365632437,
"url": "/ticket_groups/365632437",
"type": "event",
"row": "3",
"section": "305",
"quantity": 2,
"available_quantity": 2,
"wholesale_price": 30.24,
"eticket": true,
"instant_delivery": false,
"intended_for_instant_delivery": false,
"in_hand": true,
"in_hand_on": null,
"public_notes": null,
"splits": [2],
"featured": false,
"retail_price": 30.24,
"format": "Eticket",
"view_type": null,
"broadcast": "t",
"wheelchair": false,
"signature": "eExBbnMvc2w1OFVOc1o4Sjd6U0JoeTVlUU44MTF2alg5S0JBcnBrQWRwOD0tLXY0SlNIVzZ5STNXaTYyUXdKNCtyN1E9PQ==--1dd906d2e3cacb4f325876018fd3c4cfaae1445c",
"ticket_states": {
"available": 2
},
"office": {
"id": 1692,
"url": "/offices/1692",
"name": "Auto-Purchase",
"brokerage": {
"id": 1700,
"url": "/brokerages/1700",
"name": "Auto-Purchase",
"abbreviation": "TEvo Seller"
}
}
}
/** TRUNCATED **/
]
}