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.
curl -i \ -X GET \ -H "X-Signature: dGlJTI4UBJpZKTMVln/LZqblNM6GHTQahx+omG6lYEk=" \ -H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ --url 'https://api.ticketevolution.com/v9/events/1074357?'
$response = $client->showEvent([ 'event_id' => (int)1074357, ]);
{ "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.
curl -i \ -X GET \ -H "X-Signature: aUIDfd+u7mA9xp7iGbY6xIx7ZOGD0Qcb99bDkMKwtgY=" \ -H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ --url 'https://api.ticketevolution.com/v9/listings?event_id=1074357'
$response = $client→listings([ 'event_id' => 1074357 ]);
Ticket Group Properties
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. | ||||||||||||||||||||||||||
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.
| ||||||||||||||||||||||||||
in_hand and in_hand_on |
If | ||||||||||||||||||||||||||
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