Listings / Show



Name

Listings Show

Description

Shows the given Listing

Type

GET

URL

/v9/listings/:id

Credential Type

APICredential|UserCredential

Supports Pagination

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

Name

Description

Value Type

Required

id

ID of the Listing

Integer

Required

 

Response Properties

Property

Detail

Type

Property

Detail

Type

id

TEvo’s unique ID of this ticket group.

Integer

automated

Indicates if this ticket group is eligible for Order Integration which helps ensure the availability of the ticket group at order creation.

Boolean

available_quantity

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

Integer

discounted

Indicates if this ticket group is discounted.

Boolean

event

An object containing information about the event.

Object

featured

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

Boolean

format

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

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.

Boolean

owned

Indicates if the ticket group belongs to any of the offices of the same Brokerage that is making the API request

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

quantity

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

Integer

retail_price

This is wholesale_price with any inventory rules (Mark Up or Mark Down) 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

retail_price_inclusive

This is wholesale_price in USD with any inventory rules (Mark Up or Mark Down) applied plus any service_fees you have configured. Just like retail_price, you are not required to charge your customer this amount but in certain areas it may be illegal to add a service_fee during the checkout process. If requirements.inclusive_pricing is true in the Events / Show response you should display retail_price_inclusive and not add a service_fee.

In order to know which areas do not allow a service_fee (meaning you should display the retail_price_inclusive to the customer) see the Events requirements documentation.

Float

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

signature

Used at order creation to ensure the wholesale_price of the ticket has not increased during the checkout process.

String

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

tevo_section_name

A normalized identifier for the section that is intended for use with our interactive seating maps.

String

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

view_type

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

String

wheelchair

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

Boolean

wholesale_price

This is your cost in USD 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.

Tax may be added to the amount you are charged for the tickets you purchase. See Tax Quotes / Create for how to see how much tax will be collected.

Float

eticket

Indicates if the tickets are in an electronic format such as PDF or a QR Code. You should rely on format instead of eticket to know what type of ticket this is.

Boolean

 

Ticket Formats

format

allowed shipment.type

Details

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.

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.



Examples

Request

Response

Request

Response

Example of a request /v9/listings/1233641554

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