08. Event Landing Pages

The Event page is where the consumer will select the tickets they wish to purchase. It generally includes a listing of all the available Ticket Groups as well as a seating chart. The Events / Show endpoint should be used first to retrieve the information regarding the Event including the Venue at which it occurs, the time (occurs_at), and the Performers which are scheduled to be at the Event. If you wish to display our interactive seating charts you can use our seatmaps-client to display the chart as well as allow selection of sections on the map.

/events/1074357 using cURL

curl -i \
-X GET \
-H "X-Signature: dGlJTI4UBJpZKTMVln/LZqblNM6GHTQahx+omG6lYEk=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/events/1074357?'

/events/1074357 using ticketevolution-php

$response = $client->showEvent([
    'event_id' => (int)1074357,
]);

/events/1074357 JSON response

{
    "id": 1074357,
    "url": "/events/1074357",
    "name": "Philadelphia Phillies at Arizona Diamondbacks",
    "state": "shown",
    "occurs_at": "2017-06-24T19:10:00Z",
    "occurs_at_local": "2017-06-24T19:10:00-07:00",
    "updated_at": "2017-06-18T12:01:34Z",
    "notes": "",
    "owned_by_office": false,
    "products_count": 87,
    "products_eticket_count": 87,
    "available_count": 366,
    "category": {
        "id": "3",
        "name": "MLB",
        "slug": "mlb",
        "url": "/categories/3",
        "slug_url": "/categories/mlb",
        "parent": {
            "id": "2",
            "name": "Baseball",
            "slug": "baseball",
            "url": "/categories/2",
            "slug_url": "/categories/baseball",
            "parent": {
                "id": "1",
                "name": "Sports",
                "slug": "sports",
                "url": "/categories/1",
                "slug_url": "/categories/sports",
                "parent": null
            }
        }
    },
    "popularity_score": 604.95,
    "long_term_popularity_score": 0.666638,
    "stubhub_id": "9718418",
    "configuration": {
        "id": 75,
        "url": "/configurations/75",
        "name": "Baseball",
        "fanvenues_key": "6615",
        "ticket_utils_id": null,
        "seating_chart": {
            "medium": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/75/medium.jpg?1428386866",
            "large": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/75/large.jpg?1428386866"
        }
    },
    "venue": {
        "id": 110,
        "slug": "chase-field",
        "url": "/venues/110",
        "slug_url": "/venues/chase-field",
        "name": "Chase Field",
        "location": "Phoenix, AZ",
        "time_zone": "America/Phoenix"
    },
    "performances": [{
        "performer": {
            "id": 15548,
            "slug": "philadelphia-phillies",
            "slug_url": "/performers/philadelphia-phillies",
            "url": "/performers/15548",
            "name": "Philadelphia Phillies"
        },
        "primary": false
    }, {
        "performer": {
            "id": 15556,
            "slug": "arizona-diamondbacks",
            "slug_url": "/performers/arizona-diamondbacks",
            "url": "/performers/15556",
            "name": "Arizona Diamondbacks"
        },
        "primary": true
    }],
    "meta": {
        "meta_description": null,
        "meta_keywords": null,
        "nofollow": false,
        "noindex": false,
        "canonical_url": null,
        "page_title": null,
        "header_title": null,
        "paragraph_1": null,
        "paragraph_2": null,
        "paragraph_3": null,
        "image": "/images/original/missing.png"
    }
}

After making the Events / Show API request use the Listings / Index endpoint to display all the available Ticket Groups.

/listings?event_id=1074357 using cURL

curl -i \
-X GET \
-H "X-Signature: aUIDfd+u7mA9xp7iGbY6xIx7ZOGD0Qcb99bDkMKwtgY=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/listings?event_id=1074357'

/listings?event_id=1074357 using ticketevolution-php

$response = $client→listings([
    'event_id'      => 1074357
]);

/listings?event_id=1074357 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 **/


  ]
}

Ticket Group Properties

Property	Details

Property

Details

id

The unique ID of this 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

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 <option>s 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.

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`	`MobileTransfer`	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`	`MobileTransfer`	Flash Seats is very similar to TM Mobile Entry. Learn more from AXS.
`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.
`Guest_list`	`GuestList`	The very rarely used GUEST_LIST is used for exclusive parties such as some Super Bowl parties. The Client’s name(s) will be added to a guest list and the consumer must show a government issued photo ID in order to gain entry to the event.

in_hand and in_hand_on

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

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

Properties not listed in the table above can be safely ignored.

Seating Charts

Ticket Evolution’s dynamic seating charts are included and can be used via our Javascript client. Instructions are provided at that link.

Previous: Venue Landing Pages

Next: Creating a Client