Some Basic Terminology

The Ticket Evolution API includes Performers, Venues, Configurations, Events, and Ticket Groups.

Performers

Performers are an entity who will be playing/competing/performing at the Event. A performer could be a:

  • Band (Guns ‘N’ Roses)
  • Team (New Orleans Saints)
  • Individual musician (Billy Joel)
  • Speaker (Dave Ramsey)
  • Comedian (Amy Schumer)
  • Annual Event (Kentucky Derby)
  • Play/Musical/Theatrical Performance (Hamilton)

Venues

Venues are the specific locations where an event/game/performance takes place. Some examples:

  • Madison Square Garden
  • Fenway Park
  • Mercedes-Benz Superdome

Configurations
Venues have one or more configurations which is a layout or stage setup for particular events such as sports, concerts, or even specific concert tours where the stage is a custom layout. Each configuration will include a static seating chart.

Events

Events are the individual performances/competitions for which you are buying/selling tickets. Every event includes at least one Performer (but may have many) at a single Venue at a specific time (the {{occurs_at}} property). When an event is a game the “home team” Performer will be marked as primary and the “away team” will not. When an event is a concert with multiple bands/musicians the “headliner” will be marked as primary and any “opening bands” will not.

Some events may include a performer that is also the name of the event. An example of this is the Super Bowl. All year long the Super Bowl event will have a single Performer named Super Bowl, but as the teams that will be playing are decided they will be added to the event resulting in having three Performers attached to the event: Atlanta Falcons (primary since they were designated as the “home team”), New England Patriots, and Super Bowl.

Ticket Groups

Ticket Groups are collections of adjacent seats owned by the same supplier and could there be a single ticket or dozens of tickets within that ticket group. The cost of each ticket within the ticket group is the same and all seats purchased from the ticket group will be adjacent.

Listing Events Near Your Visitors

Many sites include a list of upcoming events near the visitor based on geolocation of the visitor’s IP address. The Events / Index endpoint accepts several different options for location but the recommended one is to send lat and lon of the visitor along with a within radius for the venues.

Upcoming Events within 20 miles of Las Vegas via cURL
1
2
3
4
5
curl -i \
-X GET \
-H "X-Signature: 5tsKHA+v8xm3HPPqcG9rNhu7+GqYB4N77tTk7tr/FKQ=" \
-H "X-Token: SabreHackathon:TTX2017LasVegasNV" \
--url 'https://api.sandbox.ticketevolution.com/v9/events?lat=36.1207804&lon=-115.156559&order_by=events.occurs_at&page=1&per_page=10&within=20'
Events within 20 miles of Las Vegas using ticketevolution-php
1
2
3
4
5
6
7
8
$response = $client->listEvents([
'page => 1,
'per_page => 10,
'lat => 36.1207804,
'lon => -115.156559,
'within => 20,
'order_by' => 'events.occurs_at',
]));
Events within 20 miles of Las Vegas using ticketevolution-ruby
1
2
3
4
5
6
7
8
@event = @connection.events.list({
'page => 1,
'per_page => 10,
'lat => 36.1207804,
'lon => -115.156559,
'within => 20,
'order_by' => 'events.occurs_at',
})

Comprehensive Search

Every site should have a comprehensive search available on most every page including possibly making it the main feature of the homepage. Once a visitor is has selected an event for which to view tickets and throughout the purchase process it probably makes sense to not show the search and instead use that space for useful elements.

It is suggested that this main search performs a search across Performers, Venues, and Events.

Comprehensive Search can be done via two different endpoints and you should experiment with both and decide which you prefer based on the experience you choose to present to the user.

/searches/suggestions

The /searches/suggestion endpoint was created to be used in an auto-suggest type of selector.

/searches/suggestion via cURL
1
2
3
4
5
curl -i \
-X GET \
-H "X-Signature: IKE8qY1xcCqHKoJFOC+Ett/Xpy5pzkXdCRQh5YflTCs=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/searches/suggestions?entities=events,performers,venues&fuzzy=true&limit=6&q=diamondbacks'
/searches/suggestion using ticketevolution-php
1
2
3
4
5
6
$response = $client->listSearchSuggestions([
'entities' => 'events,performers,venues',
'fuzzy' => true,
'limit' => 6,
'q' => 'diamondbacks',
]));
/searches/suggestion using ticketevolution-ruby
1
2
3
4
5
6
@search = @connection.searches.suggestions({
'entities' => 'events,performers,venues',
'fuzzy' => true,
'limit' => 6,
'q' => 'diamondbacks'
})

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
{
"total_entries": 3,
"suggestions": {
"events": [{
"id": 1073656,
"type": "events",
"name": "Arizona Diamondbacks at San Francisco Giants",
"slug": null,
"location": "San Francisco, CA",
"company": null,
"venue_name": "AT&T Park",
"occurs_at": "2017-08-05T18:05:00Z"
}, {
"id": 1073663,
"type": "events",
"name": "Arizona Diamondbacks at San Francisco Giants",
"slug": null,
"location": "San Francisco, CA",
"company": null,
"venue_name": "AT&T Park",
"occurs_at": "2017-09-16T18:05:00Z"
}, {
"id": 1073718,
"type": "events",
"name": "Arizona Diamondbacks at San Francisco Giants",
"slug": null,
"location": "San Francisco, CA",
"company": null,
"venue_name": "AT&T Park",
"occurs_at": "2017-09-17T13:05:00Z"
}, {
"id": 1073688,
"type": "events",
"name": "Arizona Diamondbacks at San Francisco Giants",
"slug": null,
"location": "San Francisco, CA",
"company": null,
"venue_name": "AT&T Park",
"occurs_at": "2017-08-04T19:15:00Z"
}, {
"id": 1073709,
"type": "events",
"name": "Arizona Diamondbacks at San Francisco Giants",
"slug": null,
"location": "San Francisco, CA",
"company": null,
"venue_name": "AT&T Park",
"occurs_at": "2017-08-06T13:05:00Z"
}, {
"id": 1073695,
"type": "events",
"name": "Arizona Diamondbacks at San Francisco Giants",
"slug": null,
"location": "San Francisco, CA",
"company": null,
"venue_name": "AT&T Park",
"occurs_at": "2017-09-15T19:15:00Z"
}, {
"id": 1073465,
"type": "events",
"name": "Arizona Diamondbacks at Los Angeles Dodgers",
"slug": null,
"location": "Los Angeles, CA",
"company": null,
"venue_name": "Dodger Stadium",
"occurs_at": "2017-07-04T18:10:00Z"
}, {
"id": 1073457,
"type": "events",
"name": "Arizona Diamondbacks at Los Angeles Dodgers",
"slug": null,
"location": "Los Angeles, CA",
"company": null,
"venue_name": "Dodger Stadium",
"occurs_at": "2017-09-05T19:10:00Z"
}, {
"id": 1073470,
"type": "events",
"name": "Arizona Diamondbacks at Los Angeles Dodgers",
"slug": null,
"location": "Los Angeles, CA",
"company": null,
"venue_name": "Dodger Stadium",
"occurs_at": "2017-07-06T19:10:00Z"
}, {
"id": 1073502,
"type": "events",
"name": "Arizona Diamondbacks at Los Angeles Dodgers",
"slug": null,
"location": "Los Angeles, CA",
"company": null,
"venue_name": "Dodger Stadium",
"occurs_at": "2017-07-05T19:10:00Z"
}, {
"id": 1073481,
"type": "events",
"name": "Arizona Diamondbacks at Los Angeles Dodgers",
"slug": null,
"location": "Los Angeles, CA",
"company": null,
"venue_name": "Dodger Stadium",
"occurs_at": "2017-09-04T17:10:00Z"
}, {
"id": 1073415,
"type": "events",
"name": "Arizona Diamondbacks at Kansas City Royals",
"slug": null,
"location": "Kansas City, MO",
"company": null,
"venue_name": "Kauffman Stadium",
"occurs_at": "2017-09-30T18:15:00Z"
}, {
"id": 1073447,
"type": "events",
"name": "Arizona Diamondbacks at Kansas City Royals",
"slug": null,
"location": "Kansas City, MO",
"company": null,
"venue_name": "Kauffman Stadium",
"occurs_at": "2017-09-29T19:15:00Z"
}, {
"id": 1073504,
"type": "events",
"name": "Arizona Diamondbacks at Los Angeles Dodgers",
"slug": null,
"location": "Los Angeles, CA",
"company": null,
"venue_name": "Dodger Stadium",
"occurs_at": "2017-09-06T19:10:00Z"
}, {
"id": 1073565,
"type": "events",
"name": "Arizona Diamondbacks at Chicago Cubs",
"slug": null,
"location": "Chicago, IL",
"company": null,
"venue_name": "Wrigley Field",
"occurs_at": "2017-08-03T13:20:00Z"
}, {
"id": 1073445,
"type": "events",
"name": "Arizona Diamondbacks at Kansas City Royals",
"slug": null,
"location": "Kansas City, MO",
"company": null,
"venue_name": "Kauffman Stadium",
"occurs_at": "2017-10-01T14:15:00Z"
}, {
"id": 1073597,
"type": "events",
"name": "Arizona Diamondbacks at Chicago Cubs",
"slug": null,
"location": "Chicago, IL",
"company": null,
"venue_name": "Wrigley Field",
"occurs_at": "2017-08-02T19:05:00Z"
}, {
"id": 1073566,
"type": "events",
"name": "Arizona Diamondbacks at Chicago Cubs",
"slug": null,
"location": "Chicago, IL",
"company": null,
"venue_name": "Wrigley Field",
"occurs_at": "2017-08-01T19:05:00Z"
}, {
"id": 1076260,
"type": "events",
"name": "Arizona Diamondbacks at St. Louis Cardinals",
"slug": null,
"location": "St Louis, MO",
"company": null,
"venue_name": "Busch Stadium",
"occurs_at": "2017-07-28T19:15:00Z"
}, {
"id": 1076261,
"type": "events",
"name": "Arizona Diamondbacks at St. Louis Cardinals",
"slug": null,
"location": "St Louis, MO",
"company": null,
"venue_name": "Busch Stadium",
"occurs_at": "2017-07-29T18:15:00Z"
}],
"performers": [],
"venues": []
}
}

/search

The /search endpoint is similar to above.

/search via cURL
1
2
3
4
5
curl -i \
-X GET \
-H "X-Signature: SAk9DIBXiITAJzwmx5RmTDEEqpGzxsGXh4QNSWB4Jig=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/search?order_by_popularity=true&page=1&per_page=6&q=diamondbacks&types=events,performers,venues'
/search using ticketevolution-php
1
2
3
4
5
6
7
$response = $client->search([
'order_by_popularity' => true,
'page' => 1,
'per_page' => 6,
'q' => 'diamondbacks',
'types' => 'events,performers,venues',
]);
/search using ticketevolution-ruby
1
2
3
4
5
6
7
@search = @connection.search.list({
'order_by_popularity' => true,
'page' => 1,
'per_page' => 6,
'q' => 'diamondbacks',
'types' => 'events,performers,venues'
})

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
{
"total_entries": 6,
"results": [{
"id": 1073656,
"url": "/events/1073656",
"name": "Arizona Diamondbacks at San Francisco Giants",
"occurs_at": "2017-08-05T18:05:00Z",
"updated_at": "2017-06-18T12:10:17Z",
"category": {
"category": {
"id": 3,
"parent_id": 2,
"name": "MLB",
"keywords": null,
"created_at": "2010-07-30T17:39:58Z",
"updated_at": "2014-05-08T13:12:31Z",
"multi_venue": false,
"has_home_team": true,
"seatgeek_id": null,
"deleted_at": null,
"slug": "mlb",
"top_parent_id": 1
}
},
"configuration": {
"configuration": {
"id": 2364,
"venue_id": 1172,
"name": "Baseball",
"capacity": null,
"primary": true,
"dynamic_map_key": "6635",
"created_at": "2010-09-24T20:18:27Z",
"updated_at": "2015-04-07T06:21:37Z",
"static_map_file_name": "1172_2364.jpg",
"static_map_content_type": "image/jpeg",
"static_map_file_size": 325636,
"static_map_updated_at": "2015-04-07T06:21:35Z",
"ga": false,
"map_not_available": false,
"deleted_at": null,
"search_terms": "'att':2 'basebal':1 'park':3",
"seat_geek_configuration_id": null,
"dvm_configuration_id": 32
}
},
"venue": {
"venue": {
"id": 1172,
"address_id": 209244,
"name": "AT&T Park",
"keywords": "",
"created_at": "2010-07-30T18:07:53Z",
"updated_at": "2014-05-08T13:11:09Z",
"allow_duplicate_section_numbers": true,
"normalized_sections": false,
"reviewed_at": "2011-03-28T17:36:19Z",
"priority": 1,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1804|1",
"scorebig_id": null,
"seatgeek_id": 1195,
"stubhub_id": 62,
"ticketcity_id": 1182,
"ticketnetwork_id": 539,
"ticketsnow_id": 1265,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"ignore_from_duplicate_events": false,
"deleted_at": null,
"freeze_name": null,
"disabled_at": null,
"popularity_score": "0.919405",
"search_terms": "'24':6 'att':1C 'ca':3 'francisco':5 'may':8 'park':2C 'plaza':9 'san':4 'us':10 'willi':7",
"slug": "at-t-park",
"ticketmaster_frontend_id": null
}
},
"state": "shown",
"performances": [{
"performer": {
"performer": {
"id": 15556,
"venue_id": 110,
"name": "Arizona Diamondbacks",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:08:46Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1573|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 701,
"ticketcity_id": 325,
"ticketnetwork_id": 58,
"ticketsnow_id": 41,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 30,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.643222",
"search_terms": "'arizona':1C 'diamondback':2C",
"slug": "arizona-diamondbacks",
"ticketmaster_frontend_id": null
}
},
"primary": false
}, {
"performer": {
"performer": {
"id": 15560,
"venue_id": 1172,
"name": "San Francisco Giants",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:06:26Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1216|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 197,
"ticketcity_id": 1719,
"ticketnetwork_id": 902,
"ticketsnow_id": 759,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.808117",
"search_terms": "'francisco':2C 'giant':3C 'san':1C",
"slug": "san-francisco-giants",
"ticketmaster_frontend_id": null
}
},
"primary": true
}],
"products_count": 1326,
"_type": "Event",
"_score": 1.5675107
}, {
"id": 1073663,
"url": "/events/1073663",
"name": "Arizona Diamondbacks at San Francisco Giants",
"occurs_at": "2017-09-16T18:05:00Z",
"updated_at": "2017-06-18T12:13:37Z",
"category": {
"category": {
"id": 3,
"parent_id": 2,
"name": "MLB",
"keywords": null,
"created_at": "2010-07-30T17:39:58Z",
"updated_at": "2014-05-08T13:12:31Z",
"multi_venue": false,
"has_home_team": true,
"seatgeek_id": null,
"deleted_at": null,
"slug": "mlb",
"top_parent_id": 1
}
},
"configuration": {
"configuration": {
"id": 2364,
"venue_id": 1172,
"name": "Baseball",
"capacity": null,
"primary": true,
"dynamic_map_key": "6635",
"created_at": "2010-09-24T20:18:27Z",
"updated_at": "2015-04-07T06:21:37Z",
"static_map_file_name": "1172_2364.jpg",
"static_map_content_type": "image/jpeg",
"static_map_file_size": 325636,
"static_map_updated_at": "2015-04-07T06:21:35Z",
"ga": false,
"map_not_available": false,
"deleted_at": null,
"search_terms": "'att':2 'basebal':1 'park':3",
"seat_geek_configuration_id": null,
"dvm_configuration_id": 32
}
},
"venue": {
"venue": {
"id": 1172,
"address_id": 209244,
"name": "AT&T Park",
"keywords": "",
"created_at": "2010-07-30T18:07:53Z",
"updated_at": "2014-05-08T13:11:09Z",
"allow_duplicate_section_numbers": true,
"normalized_sections": false,
"reviewed_at": "2011-03-28T17:36:19Z",
"priority": 1,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1804|1",
"scorebig_id": null,
"seatgeek_id": 1195,
"stubhub_id": 62,
"ticketcity_id": 1182,
"ticketnetwork_id": 539,
"ticketsnow_id": 1265,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"ignore_from_duplicate_events": false,
"deleted_at": null,
"freeze_name": null,
"disabled_at": null,
"popularity_score": "0.919405",
"search_terms": "'24':6 'att':1C 'ca':3 'francisco':5 'may':8 'park':2C 'plaza':9 'san':4 'us':10 'willi':7",
"slug": "at-t-park",
"ticketmaster_frontend_id": null
}
},
"state": "shown",
"performances": [{
"performer": {
"performer": {
"id": 15556,
"venue_id": 110,
"name": "Arizona Diamondbacks",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:08:46Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1573|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 701,
"ticketcity_id": 325,
"ticketnetwork_id": 58,
"ticketsnow_id": 41,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 30,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.643222",
"search_terms": "'arizona':1C 'diamondback':2C",
"slug": "arizona-diamondbacks",
"ticketmaster_frontend_id": null
}
},
"primary": false
}, {
"performer": {
"performer": {
"id": 15560,
"venue_id": 1172,
"name": "San Francisco Giants",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:06:26Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1216|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 197,
"ticketcity_id": 1719,
"ticketnetwork_id": 902,
"ticketsnow_id": 759,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.808117",
"search_terms": "'francisco':2C 'giant':3C 'san':1C",
"slug": "san-francisco-giants",
"ticketmaster_frontend_id": null
}
},
"primary": true
}],
"products_count": 1392,
"_type": "Event",
"_score": 1.5665506
}, {
"id": 1073718,
"url": "/events/1073718",
"name": "Arizona Diamondbacks at San Francisco Giants",
"occurs_at": "2017-09-17T13:05:00Z",
"updated_at": "2017-06-18T12:13:41Z",
"category": {
"category": {
"id": 3,
"parent_id": 2,
"name": "MLB",
"keywords": null,
"created_at": "2010-07-30T17:39:58Z",
"updated_at": "2014-05-08T13:12:31Z",
"multi_venue": false,
"has_home_team": true,
"seatgeek_id": null,
"deleted_at": null,
"slug": "mlb",
"top_parent_id": 1
}
},
"configuration": {
"configuration": {
"id": 2364,
"venue_id": 1172,
"name": "Baseball",
"capacity": null,
"primary": true,
"dynamic_map_key": "6635",
"created_at": "2010-09-24T20:18:27Z",
"updated_at": "2015-04-07T06:21:37Z",
"static_map_file_name": "1172_2364.jpg",
"static_map_content_type": "image/jpeg",
"static_map_file_size": 325636,
"static_map_updated_at": "2015-04-07T06:21:35Z",
"ga": false,
"map_not_available": false,
"deleted_at": null,
"search_terms": "'att':2 'basebal':1 'park':3",
"seat_geek_configuration_id": null,
"dvm_configuration_id": 32
}
},
"venue": {
"venue": {
"id": 1172,
"address_id": 209244,
"name": "AT&T Park",
"keywords": "",
"created_at": "2010-07-30T18:07:53Z",
"updated_at": "2014-05-08T13:11:09Z",
"allow_duplicate_section_numbers": true,
"normalized_sections": false,
"reviewed_at": "2011-03-28T17:36:19Z",
"priority": 1,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1804|1",
"scorebig_id": null,
"seatgeek_id": 1195,
"stubhub_id": 62,
"ticketcity_id": 1182,
"ticketnetwork_id": 539,
"ticketsnow_id": 1265,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"ignore_from_duplicate_events": false,
"deleted_at": null,
"freeze_name": null,
"disabled_at": null,
"popularity_score": "0.919405",
"search_terms": "'24':6 'att':1C 'ca':3 'francisco':5 'may':8 'park':2C 'plaza':9 'san':4 'us':10 'willi':7",
"slug": "at-t-park",
"ticketmaster_frontend_id": null
}
},
"state": "shown",
"performances": [{
"performer": {
"performer": {
"id": 15556,
"venue_id": 110,
"name": "Arizona Diamondbacks",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:08:46Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1573|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 701,
"ticketcity_id": 325,
"ticketnetwork_id": 58,
"ticketsnow_id": 41,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 30,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.643222",
"search_terms": "'arizona':1C 'diamondback':2C",
"slug": "arizona-diamondbacks",
"ticketmaster_frontend_id": null
}
},
"primary": false
}, {
"performer": {
"performer": {
"id": 15560,
"venue_id": 1172,
"name": "San Francisco Giants",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:06:26Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1216|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 197,
"ticketcity_id": 1719,
"ticketnetwork_id": 902,
"ticketsnow_id": 759,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.808117",
"search_terms": "'francisco':2C 'giant':3C 'san':1C",
"slug": "san-francisco-giants",
"ticketmaster_frontend_id": null
}
},
"primary": true
}],
"products_count": 2084,
"_type": "Event",
"_score": 1.5662595
}, {
"id": 1073688,
"url": "/events/1073688",
"name": "Arizona Diamondbacks at San Francisco Giants",
"occurs_at": "2017-08-04T19:15:00Z",
"updated_at": "2017-06-18T12:10:07Z",
"category": {
"category": {
"id": 3,
"parent_id": 2,
"name": "MLB",
"keywords": null,
"created_at": "2010-07-30T17:39:58Z",
"updated_at": "2014-05-08T13:12:31Z",
"multi_venue": false,
"has_home_team": true,
"seatgeek_id": null,
"deleted_at": null,
"slug": "mlb",
"top_parent_id": 1
}
},
"configuration": {
"configuration": {
"id": 2364,
"venue_id": 1172,
"name": "Baseball",
"capacity": null,
"primary": true,
"dynamic_map_key": "6635",
"created_at": "2010-09-24T20:18:27Z",
"updated_at": "2015-04-07T06:21:37Z",
"static_map_file_name": "1172_2364.jpg",
"static_map_content_type": "image/jpeg",
"static_map_file_size": 325636,
"static_map_updated_at": "2015-04-07T06:21:35Z",
"ga": false,
"map_not_available": false,
"deleted_at": null,
"search_terms": "'att':2 'basebal':1 'park':3",
"seat_geek_configuration_id": null,
"dvm_configuration_id": 32
}
},
"venue": {
"venue": {
"id": 1172,
"address_id": 209244,
"name": "AT&T Park",
"keywords": "",
"created_at": "2010-07-30T18:07:53Z",
"updated_at": "2014-05-08T13:11:09Z",
"allow_duplicate_section_numbers": true,
"normalized_sections": false,
"reviewed_at": "2011-03-28T17:36:19Z",
"priority": 1,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1804|1",
"scorebig_id": null,
"seatgeek_id": 1195,
"stubhub_id": 62,
"ticketcity_id": 1182,
"ticketnetwork_id": 539,
"ticketsnow_id": 1265,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"ignore_from_duplicate_events": false,
"deleted_at": null,
"freeze_name": null,
"disabled_at": null,
"popularity_score": "0.919405",
"search_terms": "'24':6 'att':1C 'ca':3 'francisco':5 'may':8 'park':2C 'plaza':9 'san':4 'us':10 'willi':7",
"slug": "at-t-park",
"ticketmaster_frontend_id": null
}
},
"state": "shown",
"performances": [{
"performer": {
"performer": {
"id": 15556,
"venue_id": 110,
"name": "Arizona Diamondbacks",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:08:46Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1573|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 701,
"ticketcity_id": 325,
"ticketnetwork_id": 58,
"ticketsnow_id": 41,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 30,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.643222",
"search_terms": "'arizona':1C 'diamondback':2C",
"slug": "arizona-diamondbacks",
"ticketmaster_frontend_id": null
}
},
"primary": false
}, {
"performer": {
"performer": {
"id": 15560,
"venue_id": 1172,
"name": "San Francisco Giants",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:06:26Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1216|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 197,
"ticketcity_id": 1719,
"ticketnetwork_id": 902,
"ticketsnow_id": 759,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.808117",
"search_terms": "'francisco':2C 'giant':3C 'san':1C",
"slug": "san-francisco-giants",
"ticketmaster_frontend_id": null
}
},
"primary": true
}],
"products_count": 2325,
"_type": "Event",
"_score": 1.559197
}, {
"id": 1073709,
"url": "/events/1073709",
"name": "Arizona Diamondbacks at San Francisco Giants",
"occurs_at": "2017-08-06T13:05:00Z",
"updated_at": "2017-06-18T12:10:21Z",
"category": {
"category": {
"id": 3,
"parent_id": 2,
"name": "MLB",
"keywords": null,
"created_at": "2010-07-30T17:39:58Z",
"updated_at": "2014-05-08T13:12:31Z",
"multi_venue": false,
"has_home_team": true,
"seatgeek_id": null,
"deleted_at": null,
"slug": "mlb",
"top_parent_id": 1
}
},
"configuration": {
"configuration": {
"id": 2364,
"venue_id": 1172,
"name": "Baseball",
"capacity": null,
"primary": true,
"dynamic_map_key": "6635",
"created_at": "2010-09-24T20:18:27Z",
"updated_at": "2015-04-07T06:21:37Z",
"static_map_file_name": "1172_2364.jpg",
"static_map_content_type": "image/jpeg",
"static_map_file_size": 325636,
"static_map_updated_at": "2015-04-07T06:21:35Z",
"ga": false,
"map_not_available": false,
"deleted_at": null,
"search_terms": "'att':2 'basebal':1 'park':3",
"seat_geek_configuration_id": null,
"dvm_configuration_id": 32
}
},
"venue": {
"venue": {
"id": 1172,
"address_id": 209244,
"name": "AT&T Park",
"keywords": "",
"created_at": "2010-07-30T18:07:53Z",
"updated_at": "2014-05-08T13:11:09Z",
"allow_duplicate_section_numbers": true,
"normalized_sections": false,
"reviewed_at": "2011-03-28T17:36:19Z",
"priority": 1,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1804|1",
"scorebig_id": null,
"seatgeek_id": 1195,
"stubhub_id": 62,
"ticketcity_id": 1182,
"ticketnetwork_id": 539,
"ticketsnow_id": 1265,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"ignore_from_duplicate_events": false,
"deleted_at": null,
"freeze_name": null,
"disabled_at": null,
"popularity_score": "0.919405",
"search_terms": "'24':6 'att':1C 'ca':3 'francisco':5 'may':8 'park':2C 'plaza':9 'san':4 'us':10 'willi':7",
"slug": "at-t-park",
"ticketmaster_frontend_id": null
}
},
"state": "shown",
"performances": [{
"performer": {
"performer": {
"id": 15556,
"venue_id": 110,
"name": "Arizona Diamondbacks",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:08:46Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1573|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 701,
"ticketcity_id": 325,
"ticketnetwork_id": 58,
"ticketsnow_id": 41,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 30,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.643222",
"search_terms": "'arizona':1C 'diamondback':2C",
"slug": "arizona-diamondbacks",
"ticketmaster_frontend_id": null
}
},
"primary": false
}, {
"performer": {
"performer": {
"id": 15560,
"venue_id": 1172,
"name": "San Francisco Giants",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:06:26Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1216|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 197,
"ticketcity_id": 1719,
"ticketnetwork_id": 902,
"ticketsnow_id": 759,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.808117",
"search_terms": "'francisco':2C 'giant':3C 'san':1C",
"slug": "san-francisco-giants",
"ticketmaster_frontend_id": null
}
},
"primary": true
}],
"products_count": 1910,
"_type": "Event",
"_score": 1.552449
}, {
"id": 1073695,
"url": "/events/1073695",
"name": "Arizona Diamondbacks at San Francisco Giants",
"occurs_at": "2017-09-15T19:15:00Z",
"updated_at": "2017-06-18T12:13:32Z",
"category": {
"category": {
"id": 3,
"parent_id": 2,
"name": "MLB",
"keywords": null,
"created_at": "2010-07-30T17:39:58Z",
"updated_at": "2014-05-08T13:12:31Z",
"multi_venue": false,
"has_home_team": true,
"seatgeek_id": null,
"deleted_at": null,
"slug": "mlb",
"top_parent_id": 1
}
},
"configuration": {
"configuration": {
"id": 2364,
"venue_id": 1172,
"name": "Baseball",
"capacity": null,
"primary": true,
"dynamic_map_key": "6635",
"created_at": "2010-09-24T20:18:27Z",
"updated_at": "2015-04-07T06:21:37Z",
"static_map_file_name": "1172_2364.jpg",
"static_map_content_type": "image/jpeg",
"static_map_file_size": 325636,
"static_map_updated_at": "2015-04-07T06:21:35Z",
"ga": false,
"map_not_available": false,
"deleted_at": null,
"search_terms": "'att':2 'basebal':1 'park':3",
"seat_geek_configuration_id": null,
"dvm_configuration_id": 32
}
},
"venue": {
"venue": {
"id": 1172,
"address_id": 209244,
"name": "AT&T Park",
"keywords": "",
"created_at": "2010-07-30T18:07:53Z",
"updated_at": "2014-05-08T13:11:09Z",
"allow_duplicate_section_numbers": true,
"normalized_sections": false,
"reviewed_at": "2011-03-28T17:36:19Z",
"priority": 1,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1804|1",
"scorebig_id": null,
"seatgeek_id": 1195,
"stubhub_id": 62,
"ticketcity_id": 1182,
"ticketnetwork_id": 539,
"ticketsnow_id": 1265,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"ignore_from_duplicate_events": false,
"deleted_at": null,
"freeze_name": null,
"disabled_at": null,
"popularity_score": "0.919405",
"search_terms": "'24':6 'att':1C 'ca':3 'francisco':5 'may':8 'park':2C 'plaza':9 'san':4 'us':10 'willi':7",
"slug": "at-t-park",
"ticketmaster_frontend_id": null
}
},
"state": "shown",
"performances": [{
"performer": {
"performer": {
"id": 15556,
"venue_id": 110,
"name": "Arizona Diamondbacks",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:08:46Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1573|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 701,
"ticketcity_id": 325,
"ticketnetwork_id": 58,
"ticketsnow_id": 41,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 30,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.643222",
"search_terms": "'arizona':1C 'diamondback':2C",
"slug": "arizona-diamondbacks",
"ticketmaster_frontend_id": null
}
},
"primary": false
}, {
"performer": {
"performer": {
"id": 15560,
"venue_id": 1172,
"name": "San Francisco Giants",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:06:26Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1216|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 197,
"ticketcity_id": 1719,
"ticketnetwork_id": 902,
"ticketsnow_id": 759,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.808117",
"search_terms": "'francisco':2C 'giant':3C 'san':1C",
"slug": "san-francisco-giants",
"ticketmaster_frontend_id": null
}
},
"primary": true
}],
"products_count": 1749,
"_type": "Event",
"_score": 1.5511035
}]
}

Performer Landing Page

Each performer should have their own “landing page” which includes information about that performer and shows any upcoming Events for that performer. Because the Ticket Evolution catalog includes over 45000 Performers, these pages are dynamically created and usually use the slug property of the Performer to create the URL. In the case of the Arizona Diamondbacks the slug is arizona-diamondbacks and your URL might look something like www.myawesometicketsite.com/arizona-diamondbacks-tickets

To generate such a page you should retrieve the Performer slug from the URL, which in the example of www.myawesometicketsite.com/arizona-diamondbacks-tickets would be arizona-diamondbacks. Then two API requests are made, the first one being Performers / Show in order to retrieve information about the performer.

/performers/arizona-diamondbacks using cURL
1
2
3
4
5
curl -i \
-X GET \
-H "X-Signature: Eha/EE1EbP8mYqmf72AYOq0ee641Y/Q6EoRgDGv1+zM=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/performers/arizona-diamondbacks?'
/performers/arizona-diamondbacks using ticketevolution-php
1
2
3
$response = $client->showPerformer([
'performer_id' => 'arizona-diamondbacks',
]);
/performers/arizona-diamondbacks using ticketevolution-ruby
1
@performer = @connection.performers.show('arizona-diamondbacks')

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
{
"id": 15556,
"name": "Arizona Diamondbacks",
"keywords": "",
"popularity_score": "0.643222",
"url": "/performers/15556",
"slug_url": "/performers/arizona-diamondbacks",
"updated_at": "2014-05-08T13:08:46Z",
"upcoming_events": {
"first": "2017-06-18T13:35:00Z",
"last": "2017-10-01T14:15:00Z"
},
"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"
},
"slug": "arizona-diamondbacks",
"venue": {
"id": 110,
"slug": "chase-field",
"name": "Chase Field",
"url": "/venue/110",
"slug_url": "/venue/chase-field",
"updated_at": "2014-05-08T13:11:31Z",
"address": {
"street_address": "401 East Jefferson Street",
"extended_address": null,
"locality": "Phoenix",
"region": "AZ",
"postal_code": "85004",
"country_code": "US",
"created_at": "2012-04-12T03:35:30Z"
}
},
"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
}
}
},
"opponents": [],
"venues": []
}

After making the Performer / Show API request the id of the Performer (15556 in this example) can be used to display upcoming Events using the Events / Index endpoint.

/events using cURL
1
2
3
4
5
curl -i \
-X GET \
-H "X-Signature: oy8oDMMfSjCoz6R3oWsE5/2CsKYlypgnHbL9YtDLUAo=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/events?page=1&per_page=2&performer_id=15556'
/events using ticketevolution-php
1
2
3
$response = $client->listEvents([
'performer_id' => (int)15556,
]);
/events using ticketevolution-ruby
1
2
3
@event = @connection.events.list({
'performer_id' => 15556
})

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
{
"current_page": 1,
"per_page": 2,
"total_entries": 93,
"events": [{
"id": 1075927,
"url": "/events/1075927",
"name": "Arizona Diamondbacks at Philadelphia Phillies",
"state": "shown",
"occurs_at": "2017-06-18T13:35:00Z",
"occurs_at_local": "2017-06-18T13:35:00-04:00",
"updated_at": "2017-06-18T12:00:33Z",
"notes": null,
"owned_by_office": false,
"products_count": 0,
"products_eticket_count": 0,
"available_count": 42,
"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": 1475.87,
"long_term_popularity_score": 0.691195,
"stubhub_id": "9714868",
"configuration": {
"id": 2841,
"url": "/configurations/2841",
"name": "Baseball",
"fanvenues_key": "6575",
"ticket_utils_id": null,
"seating_chart": {
"medium": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/2841/medium.jpg?1429172102",
"large": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/2841/large.jpg?1429172102"
}
},
"venue": {
"id": 2877,
"slug": "citizens-bank-park",
"url": "/venues/2877",
"slug_url": "/venues/citizens-bank-park",
"name": "Citizens Bank Park",
"location": "Philadelphia, PA",
"time_zone": "America/New_York"
},
"performances": [{
"performer": {
"id": 15556,
"slug": "arizona-diamondbacks",
"slug_url": "/performers/arizona-diamondbacks",
"url": "/performers/15556",
"name": "Arizona Diamondbacks"
},
"primary": false
}, {
"performer": {
"id": 15548,
"slug": "philadelphia-phillies",
"slug_url": "/performers/philadelphia-phillies",
"url": "/performers/15548",
"name": "Philadelphia Phillies"
},
"primary": true
}]
}, {
"id": 1076486,
"url": "/events/1076486",
"name": "Arizona Diamondbacks at Colorado Rockies",
"state": "shown",
"occurs_at": "2017-06-20T18:40:00Z",
"occurs_at_local": "2017-06-20T18:40:00-06:00",
"updated_at": "2017-06-18T12:00:46Z",
"notes": null,
"owned_by_office": false,
"products_count": 213,
"products_eticket_count": 213,
"available_count": 576,
"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": 512.54,
"long_term_popularity_score": 0.665749,
"stubhub_id": "9715688",
"configuration": {
"id": 2962,
"url": "/configurations/2962",
"name": "Baseball",
"fanvenues_key": "6620",
"ticket_utils_id": null,
"seating_chart": {
"medium": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/2962/medium.jpg?1428732835",
"large": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/2962/large.jpg?1428732835"
}
},
"venue": {
"id": 339,
"slug": "coors-field",
"url": "/venues/339",
"slug_url": "/venues/coors-field",
"name": "Coors Field",
"location": "Denver, CO",
"time_zone": "America/Denver"
},
"performances": [{
"performer": {
"id": 15556,
"slug": "arizona-diamondbacks",
"slug_url": "/performers/arizona-diamondbacks",
"url": "/performers/15556",
"name": "Arizona Diamondbacks"
},
"primary": false
}, {
"performer": {
"id": 15557,
"slug": "colorado-rockies",
"slug_url": "/performers/colorado-rockies",
"url": "/performers/15557",
"name": "Colorado Rockies"
},
"primary": true
}]
}]
}

Venue Landing Page

Many sites also choose to build a landing page for each venue (there are over 13,000 venues available via our API).

These pages are generated very similarly to the Performer Landing Pages using the Venue slug from the URL, which in the example of www.myawesometicketsite.com/venues/chase-field-tickets would be chase-field. Then two API requests are made, the first one being Venues / Show in order to retrieve information about the performer.

/venues/chase-field using cURL
1
2
3
4
5
curl -i \
-X GET \
-H "X-Signature: Vmv9v4xDs/0QRNqLWmhT5sjqeoF08Kcxrjcbs9tvP6M=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/venues/chase-field?'
/venues/chase-field using ticketevolution-php
1
2
3
$response = $client->showVenue([
'venue_id' => 'chase-field',
]);
/venues/chase-field using ticketevolution-ruby
1
@venue = @connection.venues.show('chase-field')

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
{
"id": 110,
"name": "Chase Field",
"keywords": "",
"popularity_score": "0.734308",
"url": "/venues/110",
"slug_url": "/venues/chase-field",
"location": "Phoenix, AZ",
"country_code": "US",
"updated_at": "2014-05-08T13:11:31Z",
"address": {
"street_address": "401 East Jefferson Street",
"extended_address": null,
"locality": "Phoenix",
"region": "AZ",
"postal_code": "85004",
"country_code": "US",
"location": "Phoenix, AZ",
"latitude": 33.4528292,
"longitude": -112.0685027,
"label": null,
"created_at": "2012-04-12T03:35:30Z"
},
"upcoming_events": {
"first": "2017-06-23T18:40:00Z",
"last": "2018-01-01T00:00:00Z"
},
"slug": "chase-field",
"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 Performer / Show API request the id of the Performer (15556 in this example) can be used to display upcoming Events using the Events / Index endpoint.

/events using cURL
1
2
3
4
5
curl -i \
-X GET \
-H "X-Signature: D/OPdqD6qrr1O5nLmvYNArnn9MxyuhDZQh8wf8Ho9Qk=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/events?page=1&per_page=2&venue_id=110'
/events using ticketevolution-php
1
2
3
$response = $client->listEvents([
'venue_id' => (int)110,
]);
/events using ticketevolution-ruby
1
2
3
@event = @connection.events.list({
'venue_id' => 110
})

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
{
"current_page": 1,
"per_page": 2,
"total_entries": 47,
"events": [{
"id": 1074303,
"url": "/events/1074303",
"name": "Philadelphia Phillies at Arizona Diamondbacks",
"state": "shown",
"occurs_at": "2017-06-23T18:40:00Z",
"occurs_at_local": "2017-06-23T18:40:00-07:00",
"updated_at": "2017-06-18T12:01:10Z",
"notes": null,
"owned_by_office": false,
"products_count": 103,
"products_eticket_count": 103,
"available_count": 630,
"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": 326.24,
"long_term_popularity_score": 0.669116,
"stubhub_id": "9718417",
"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
}]
}, {
"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
}]
}]
}

Event Landing Page

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.

/events/1074357 using cURL
1
2
3
4
5
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
1
2
3
$response = $client->showEvents([
'event_id' => (int)1074357,
]);
/events/1074357 using ticketevolution-ruby
1
@event = @connection.events.show(1074357)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
{
"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)

In Sandbox you need to change the /media.sandbox.ticketevolution.com/ portion of the URL to /media.ticketevolution.com/
/ticket_groups?event_id=1074357 using cURL
1
2
3
4
5
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'
/ticket_groups?event_id=1074357 using ticketevolution-php
1
2
3
4
$response = $client->listTicketGroups([
'event_id' => (int)1074357,
'lightweight' => true,
]);
/ticket_groups?event_id=1074357 using ticketevolution-ruby
1
2
3
4
@ticket_group = @connection.ticket_groups.list({
'event_id' => 1074357,
'lightweight' => true
})

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
{
"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.
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 <options>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 Legacy indicator of the format of the ticket. One of: Paperless, GuestList, FlashSeats, TMMobile, Flash_seats, Guest_list, Tm_mobile. After July 2017 you should use format_new instead.
format_revised Indicator of the format of the ticket. format_revised supersedes format after July 2017.
If there are certain types of formats or expected_delivery_types that you do not wish to sell you may filter them out when displaying Ticket Groups.

format_new allowed expected_delivery_types Details
PHYSICAL FedEx (expected_delivery_type will also include the expected service_type) 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.
LOCAL_PICKUP 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.
PRINT_AT_HOME FILE_DOWNLOAD 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.
TM_MOBILE_ENTRY ELECTRONIC_TRANSFER 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.
FILE_DOWNLOAD 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.
FLASH_SEATS ELECTRONIC_TRANSFER Flash Seats is very similar to TM Mobile Entry. Learn more from Flash Seats.
CREDIT_CARD_ENTRY FedEx (expected_delivery_type will also include the expected service_type) 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.
LOCAL_PICKUP 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.
WALK_IN 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 GUEST_LIST 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_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.
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.

Last Modified on Friday, September 8, 2017