Listings / Show
Name | Listings Show |
---|---|
Description | Shows the given Listing |
Type |
|
URL |
|
| |
No |
Long Description
Returns the specified Listing.
If you are testing in the Sandbox the events named "Test Event" is recommended as it has several large listings of various types and formats.
Each Listing in the response will include an available_quantity
property, which indicates how many tickets are currently available to sell.
The splits
array shows which quantities are available to purchase. For example, in splits:[1,2,3,4,5,7]
an attempt to purchase 6 tickets will fail.
Parameters
Name | Description | Value Type | Required |
---|---|---|---|
| ID of the Listing | Integer | Required |
Response Properties
Property | Detail | Type |
---|---|---|
| TEvo’s unique ID of this ticket group. | Integer |
| Indicates if this ticket group is eligible for Order Integration which helps ensure the availability of the ticket group at order creation. | Boolean |
| This is how many total tickets are available from this ticket group. | Integer |
| Indicates if this ticket group is discounted. | Boolean |
| An object containing information about the event. | Object |
| A boolean property used to indicate if a ticket group is considered to be “featured” based upon rules you provide. | Boolean |
| Indicator of the format of the ticket, which also generally dictates how the tickets will be delivered to your customer. See table below for possible formats. | String |
|
If | Boolean & Date |
| 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 | Boolean |
| Indicates if the ticket group belongs to any of the offices of the same Brokerage that is making the API request | Boolean |
| These notes should be displayed to the Client before purchasing and may include important details that may influence the buying decision. | String|null |
| This is how many total tickets are available from this ticket group. | Integer |
| This is | Float |
| This is | Float |
| Indicates where seats are located. | String |
| String | |
| Used at order creation to ensure the | String |
| 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 | Array |
| A normalized identifier for the section that is intended for use with our interactive seating maps. | String |
| Either | String |
| One of: | String |
| A boolean property used to indicate if the tickets are marked as intended to be used by wheelchair or otherwise handicapped patrons. | Boolean |
| 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 | Float |
| Indicates if the tickets are in an electronic format such as PDF or a QR Code. You should rely on | Boolean |
Ticket Formats
| allowed shipment.type | Details |
---|---|---|
|
| 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 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. | |
|
| 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. |
|
| 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 is very similar to TM Mobile Entry. Learn more from Flash Seats. |
|
| 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. |
| 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. | |
| 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. |
Examples
Request | Response |
---|---|
Example of a request | {
"automated": false,
"available_quantity": 7,
"discounted": false,
"eticket": false,
"featured": true,
"format": "Flash_seats",
"id": 1272907745,
"in_hand": false,
"in_hand_on": "2023-02-26",
"instant_delivery": false,
"owned": true,
"public_notes": "Orders for these tickets will be remain pending. Scan your tickets from your mobile phone for this event. These tickets are for testing purposes only.",
"quantity": 7,
"retail_price": 11.74,
"retail_price_inclusive": 14.08,
"row": "11",
"section": "102",
"service_fee": 0,
"signature": "NlhRYldEQ3pybWN4QUJhK0xJbE1paEswaiswK0N6MW14a2syWWlvOXlIOD0tLTlESmI2bEdQbkRwd0N2WElWdHFIOFE9PQ==--72913d99d19f25320515dd08abfa80931f0ede3f",
"splits": [
1,
2,
3,
4,
5,
7
],
"tevo_section_name": "102",
"type": "event",
"view_type": null,
"wheelchair": false,
"wholesale_price": 11.18,
"face_value": 15.0,
"seller_cost": 17.89
} |