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 image. Static seating chart images are included with API access and can be retrieved using URLs supplied in the response from the Events / Show endpoint which 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.
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
curl -i \ -X GET \ -H "X-Signature: dGlJTI4UBJpZKTMVln/LZqblNM6GHTQahx+omG6lYEk=" \ -H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ --url 'https://api.ticketevolution.com/v9/events/1074357?' |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
$response = $client->showEvent([ 'event_id' => (int)1074357, ]); |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
@event = @connection.events.show(1074357) |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "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 Ticket Groups / Index endpoint to display all the available Ticket Groups. You should always use lightweight=true
with the /ticket_groups endpoint.
If you wish to display a static seating chart for the event you can find URLs for medium and large images under venue->configurations→seating_chart (e.g.:
https://s3.amazonaws.com/media.sandbox.ticketevolution.com/configurations/default_maps/ga_1000.jpg)
media.sandbox.ticketevolution.com/
portion of the URL to /media.ticketevolution.com/
true
with the /ticket_groups endpoint.
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
curl -i \ -X GET \ -H "X-Signature: aUIDfd+u7mA9xp7iGbY6xIx7ZOGD0Qcb99bDkMKwtgY=" \ -H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ --url 'https://api.ticketevolution.com/v9/ticket_groups?event_id=1074357&lightweight=true' |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
$response = $client->listTicketGroups([ 'event_id' => (int)1074357, 'lightweight' => true, ]); |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
@ticket_group = @connection.ticket_groups.list({ 'event_id' => 1074357, 'lightweight' => true }) |
Code Block | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{ "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 | |||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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. | |||||||||||||||||||||||||||
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. | |||||||||||||||||||||||||||
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_date |
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. Only Ticket Groups with an expected_delivery_type of FILE_DOWNLOAD can be Instant Delivery. | |||||||||||||||||||||||||||
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.
Info |
---|
When using our dynamic seating charts you will want to include |
Previous: Venue Landing Pages
Next: Creating a Client