Name	Ticket Groups Show
Description	Display details for a single ticket group
Type	GET
URL	/v9/ticket_groups/:ticket_group_id
Credential Type	API\|User

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

Display details for a single ticket group.

Each Ticket Group includes an available_ticket_count property, which indicates how many tickets are currently available to sell.

Request Parameters

Name	Description	Type	Presence	Location	Other
`ticket_group_id`	The `id` of the individual ticket group.	Integer	Required	URI
`ticket_list`	Whether or not to include a ticket_list array with details of the individual tickets in the group	Boolean	Optional	Query

Response Properties

Property Details Type

id

The unique ID of this ticket group.

Integer

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 String

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"

String

row String

available_quantity

This is how many total tickets are available from this ticket group.

Integer

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 <option>s with these values.

Array

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.

Float

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.

Float

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. String

format

Indicator of the format of the ticket, which also generally dictates how the tickets will be delivered to your customer.

`format`	allowed shipment.type	Details
`Physical`	`FedEx`	The traditional paper or “hard” ticket that has existed for dozens of years. Physical tickets usually include a barcode that must be scanned in order to gain entry to the event.
`Physical`	`LocalPickup`	Physical tickets are generally shipped via FedEx, but in some cases may need to be picked up by the consumer at the venue’s Will Call or a location near the venue. The seller will provide the exact location after the order is accepted.
`Eticket`	`Eticket`	These tickets are generally PDF files that the consumer will download and print out to take to the event and generally include a barcode that must be scanned in order to gain entry to the event. Sometimes the seller will provide a PDF of the mobile entry ticket images. These must* be displayed on a mobile phone* so the barcodes can be scanned for entry. The venue will not allow entry if these are printed on paper.
`TM_mobile`	`TMMobile`	Mobile Entry is rapidly becoming the most prolific way tickets are distributed. The tickets purchased will be transferred to the consumer's email address. The consumer must then accept the transfer and then be prepared to show the tickets on their mobile device in order to gain entry to the event. Learn more from Ticketmaster.
`Flash_seats`	`FlashSeats`	Flash Seats is very similar to TM Mobile Entry. Learn more from Flash Seats.
`Paperless`	`FedEx`	For some events, no actual tickets are issued and instead the credit card that originally purchased the tickets must be scanned in order to gain entry to the event. Learn more from Ticketmaster. In most cases a gift card with instructions will be sent to the consumer via FedEx and the consumer will use that gift card to gain entry to the event. The gift card does not need to be returned after the event and may be discarded.
	`LocalPickup`	In some cases it may be too late to ship the gift card required for entry and the Client may need to be picked up by the consumer at the venue’s Will Call or a location near the venue. The seller will provide the exact location after the order is accepted.
	`Paperless`	In other cases the consumer may need to meet a representative of the company selling the tickets at the venue and the representative will walk the consumer through the process of entering the event.

String

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.

Boolean

Date

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.

Boolean

public_notes

These notes should be displayed to the Client before purchasing and may include important details that may influence the buying decision.

String|null

featured

A boolean property used to indicate if a ticket group is considered to be “featured” based upon rules you provide.

Boolean

wheelchair

A boolean property used to indicate if the tickets are marked as intended to be used by wheelchair or otherwise handicapped patrons.

Boolean

view_type

One of: Full, Obstructed, Possibly Obstructed, or Partially Obstructed

String

Response Properties You Should Ignore

These properties may be either deprecated or for internal use only and can generally be ignored.

Name	Description	Type	Notes
evopay_discount	Deprecated	Float	Deprecated
evopay_discount_price	Deprecated	Float	Deprecated
broadcast	Indicates if the ticket group should be broadcast	Boolean	Internal Use Only
freshness	Used to indicate the last time this ticket group was updated	String	Deprecated
ticket_costs	An array of the costs of each ticket in the group	Array	Deprecated
ticket_states	Describes the various states and quantities within a ticket group	Object	Internal Use Only
ticket_list	Contains information about the individual tickets within a ticket group	Array of Objects	Internal Use Only
ticket_purchase_order_ids	Contains information about the purchase order for the individual tickets within a ticket group	Array	Internal Use Only
signature	Unique string identifying this ticket group	String	Internal Use Only
office	The office which is selling these tickets	Object	Deprecated
ticket_hold_ids	An array of the hold IDs if any tickets form the group are currently held	Array	Deprecated
eticket	Indicates if the tickets are in an electronic format such as PDF or a QR Code	Boolean	Deprecated
quantity	The total number of tickets. See `available_quantity` to know how many may be purchased	Integer	Internal Use Only
exchange_notes	Notes that are only shown to the B2B marketplace	String\|null	Internal Use Only
private_notes	Private notes that are only shown to the owner of the ticket group	String\|null	Internal Use Only

Examples

Request

Response

/v9/ticket_groups/26294236?ticket_list=true

{
   "total_entries":25,
   "ticket_groups":[
      {
         "evopay_discount":0.0,
         "face_value":null,
         "row":"TROPHY CLUB",
         "type":"event",
         "wheelchair":false,
         "broadcast":"t",
         "private_notes":null,
         "eticket":true,
		 "instant_delivery":true,
         "freshness":"> 240 mins",
         "featured":false,
         "section":"TROPHY CLUB",
         "ticket_costs":[
            "NULL",
            "NULL"
         ],
         "exchange_notes":null,
         "ticket_states":{
            "available":2
         },
         "url":"/ticket_groups/26294236",
         "format":null,
         "ticket_list":[
            {
               "purchase_order_id":0,
               "hold_until":"UL",
               "state":"available",
               "cost":null,
               "hold_id":0,
               "spec":null,
               "id":197963079,
               "seat":0,
               "eticket_id": 3124
            },
            {
               "purchase_order_id":0,
               "hold_until":"UL",
               "state":"available",
               "cost":null,
               "hold_id":0,
               "spec":null,
               "id":197963077,
               "seat":0,
			   "eticket_id": null
            }
         ],
         "event":{
            "occurs_at":"2013-07-08T08:00:00Z",
            "url":"/events/304289",
            "name":"US Senior Open Golf",
            "id":304289
         },
         "ticket_purchase_order_ids":[
            "NULL",
            "NULL"
         ],
         "updated_at":"2013-01-09T18:29:10Z",
         "created_at":"2012-10-19T05:30:16Z",
         "in_hand":true,
         "wholesale_price":29.0,
         "signature":"c07fa6aaf213d8c484f7bf4d2a60ab89",
         "splits":[
            2
         ],
         "office":{
            "brokerage":{
               "url":"/brokerages/507",
               "abbreviation":"Red Zone",
               "name":"Red Zone Tickets",
               "id":507
            },
            "url":"/offices/134",
            "name":"Main Office",
            "id":134
         },
         "view_type":null,
         "seats":[

         ],
         "ticket_hold_ids":[
            "NULL",
            "NULL"
         ],
         "quantity":2,
         "id":26294236,
         "evopay_discount_price":29.0,
         "retail_price":49.0,
         "public_notes":null,
         "in_hand_on":null
      },
      {
         "evopay_discount":0.0,
         "face_value":null,
         "row":"GROUNDS",
         "type":"event",
         "wheelchair":false,
         "broadcast":"t",
         "private_notes":null,
         "eticket":false,
         "freshness":"> 240 mins",
         "featured":false,
         "section":"GROUNDS",
         "ticket_costs":[
            "NULL",
            "NULL"
         ],
         "exchange_notes":null,
         "ticket_states":{
            "available":2
         },
         "url":"/ticket_groups/26294237",
         "format":null,
         "ticket_list":[
            {
               "purchase_order_id":0,
               "hold_until":"UL",
               "state":"available",
               "cost":null,
               "hold_id":0,
               "spec":null,
               "id":197963094,
               "seat":0,
			   "eticket_id": 1234
            },
            {
               "purchase_order_id":0,
               "hold_until":"UL",
               "state":"available",
               "cost":null,
               "hold_id":0,
               "spec":null,
               "id":197963093,
               "seat":0,
			   "eticket_id": null
            }
         ],
         "event":{
            "occurs_at":"2013-07-08T08:00:00Z",
            "url":"/events/304289",
            "name":"US Senior Open Golf",
            "id":304289
         },
         "ticket_purchase_order_ids":[
            "NULL",
            "NULL"
         ],
         "updated_at":"2013-01-09T18:29:10Z",
         "created_at":"2012-10-19T05:30:14Z",
         "in_hand":true,
         "wholesale_price":13.0,
         "signature":"5c09bdc07c69ac0f11c687648518f714",
         "splits":[
            2
         ],
         "office":{
            "brokerage":{
               "url":"/brokerages/507",
               "abbreviation":"Red Zone",
               "name":"Red Zone Tickets",
               "id":507
            },
            "url":"/offices/134",
            "name":"Main Office",
            "id":134
         },
         "view_type":null,
         "seats":[

         ],
         "ticket_hold_ids":[
            "NULL",
            "NULL"
         ],
         "quantity":2,
         "id":26294237,
         "evopay_discount_price":13.0,
         "retail_price":33.0,
         "public_notes":null,
         "in_hand_on":null
      }
   ]
}

Application Programming Interface

Ticket Groups / Show - Removed

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

Use Listings / Index and Listings / Show instead.

Long Description

Request Parameters

Response Properties

Response Properties You Should Ignore

Examples