thrillcall-api 0.0.4 → 0.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
data/Gemfile.lock CHANGED
@@ -1,34 +1,36 @@
1
1
  PATH
2
2
  remote: .
3
3
  specs:
4
- thrillcall-api (0.0.3)
4
+ thrillcall-api (0.0.5)
5
5
  faraday (~> 0.7.0)
6
6
 
7
7
  GEM
8
8
  remote: http://rubygems.org/
9
9
  specs:
10
10
  ZenTest (4.6.2)
11
- addressable (2.2.6)
11
+ addressable (2.2.7)
12
12
  albino (1.3.3)
13
13
  posix-spawn (>= 0.3.6)
14
14
  autotest (4.4.6)
15
15
  ZenTest (>= 4.4.1)
16
- autotest-fsevent (0.2.7)
16
+ autotest-fsevent (0.2.8)
17
17
  sys-uname
18
18
  autotest-growl (0.2.16)
19
- awesome_print (1.0.1)
19
+ awesome_print (1.0.2)
20
20
  diff-lcs (1.1.3)
21
21
  faker (0.9.5)
22
22
  i18n (~> 0.4)
23
- faraday (0.7.5)
24
- addressable (~> 2.2.6)
25
- multipart-post (~> 1.1.3)
26
- rack (>= 1.1.0, < 2)
23
+ faraday (0.7.6)
24
+ addressable (~> 2.2)
25
+ multipart-post (~> 1.1)
26
+ rack (~> 1.1)
27
+ ffi (1.0.11)
27
28
  i18n (0.6.0)
28
- multipart-post (1.1.4)
29
+ multipart-post (1.1.5)
29
30
  nokogiri (1.4.7)
30
31
  posix-spawn (0.3.6)
31
- rack (1.3.5)
32
+ rack (1.4.1)
33
+ rake (0.9.2.2)
32
34
  redcarpet (1.17.2)
33
35
  rspec (2.7.0)
34
36
  rspec-core (~> 2.7.0)
@@ -38,7 +40,9 @@ GEM
38
40
  rspec-expectations (2.7.0)
39
41
  diff-lcs (~> 1.1.2)
40
42
  rspec-mocks (2.7.0)
41
- sys-uname (0.8.6)
43
+ sys-uname (0.9.0)
44
+ ffi (>= 1.0.0)
45
+ tzinfo (0.3.31)
42
46
 
43
47
  PLATFORMS
44
48
  ruby
@@ -47,12 +51,14 @@ DEPENDENCIES
47
51
  ZenTest (~> 4.6.2)
48
52
  albino (~> 1.3.3)
49
53
  autotest (~> 4.4.6)
50
- autotest-fsevent (~> 0.2.7)
54
+ autotest-fsevent (~> 0.2.8)
51
55
  autotest-growl (~> 0.2.16)
52
56
  awesome_print (~> 1.0.1)
53
57
  bundler (>= 1.0.0)
54
58
  faker (~> 0.9.5)
55
59
  nokogiri (~> 1.4.6)
60
+ rake (~> 0.9.2.2)
56
61
  redcarpet (~> 1.17.2)
57
62
  rspec (~> 2.7.0)
58
63
  thrillcall-api!
64
+ tzinfo (~> 0.3.31)
data/README.md CHANGED
@@ -1,5 +1,5 @@
1
1
  # Thrillcall API
2
- This document describes the Thrillcall API v2, and usage for the provided Ruby API wrapper gem.
2
+ This document describes the Thrillcall API v3, and usage for the provided Ruby API wrapper gem.
3
3
 
4
4
  # Ruby API Wrapper
5
5
  ### Usage:
@@ -56,7 +56,7 @@ Provide additional instantiation options:
56
56
 
57
57
  #---------------------------------------------------------------#
58
58
  # The default SSL endpoint is "https://api.thrillcall.com/api/".
59
- # The default API version is 2.
59
+ # The default API version is 3.
60
60
  # By default, Faraday access logging is turned off.
61
61
  # Override if necessary:
62
62
  #---------------------------------------------------------------#
@@ -94,7 +94,7 @@ This gem is a convenience wrapper around the excellent Faraday project. If more
94
94
  require 'json'
95
95
 
96
96
  MY_API_KEY = "1234567890abcdef"
97
- BASE_URL = "https://api.thrillcall.com/api/v2/"
97
+ BASE_URL = "https://api.thrillcall.com/api/v3/"
98
98
  HEADERS = { :accept => 'application/json' }
99
99
 
100
100
  connection = Faraday.new( :url => BASE_URL, :headers => HEADERS ) do |builder|
@@ -134,7 +134,7 @@ These are valid parameters for any endpoint, however, they will only be used by
134
134
 
135
135
  _Default: 100_
136
136
 
137
- Sets the maximum number of results to return. Cannot be above 100.
137
+ Sets the maximum number of results to return. Cannot be above 200.
138
138
 
139
139
  - <a name="page" />**page** _integer_
140
140
 
@@ -144,6 +144,13 @@ These are valid parameters for any endpoint, however, they will only be used by
144
144
 
145
145
  Specifies the page number. If limit is 10, then page = 2 will return results #20 through #29
146
146
 
147
+ - <a name="time_zone" />**time\_zone** _string (format: TZ Database string, eg "America/Los\_Angeles")_
148
+
149
+ _Default: UTC_
150
+ _For Metro Area endpoints, the default is instead the Metro Area's time zone and cannot be overridden._
151
+
152
+ **[min\_date](#min_date)** and **[max\_date](#max_date)** will be calculated based on this time zone.
153
+
147
154
  - <a name="min_date" />**min\_date** _string (format: "YYYY-MM-DD")_
148
155
 
149
156
  _Default: Today_
@@ -156,6 +163,18 @@ These are valid parameters for any endpoint, however, they will only be used by
156
163
 
157
164
  Results after this date will not be returned.
158
165
 
166
+ - <a name="min_updated_at" />**min\_updated\_at** _string (format: "YYYY-MM-DD")_
167
+
168
+ _Default: none_
169
+
170
+ Results with updated_at columns before this date will not be returned.
171
+
172
+ - <a name="max_date" />**max\_updated\_at** _string (format: "YYYY-MM-DD")_
173
+
174
+ _Default: none_
175
+
176
+ Results with updated_at columns after this date will not be returned.
177
+
159
178
  - <a name="lat" />**lat** _float_
160
179
 
161
180
  _Default: none_
@@ -205,6 +224,12 @@ These are valid parameters for any endpoint, however, they will only be used by
205
224
 
206
225
  If set to _true_ or _1_, will only return results that have tickets associated with them.
207
226
 
227
+ - <a name="show_disabled_events" />**show\_disabled\_events** _boolean_
228
+
229
+ _Default: false_
230
+
231
+ If set to _true_ or _1_, will not filter out events which have been disabled internally.
232
+
208
233
  - <a name="show_unconfirmed_events" />**show\_unconfirmed\_events** _boolean_
209
234
 
210
235
  _Default: false_
@@ -261,7 +286,7 @@ These are valid parameters for any endpoint, however, they will only be used by
261
286
 
262
287
  - <a name="referral_code" />**referral\_code** _string_
263
288
 
264
- The referral code to be used during registration. Both the owner of the code as well as the new user will receive a point on their referral counts.
289
+ The referral code to be used during registration. Both the owner of the code as well as the new user will receive a referral credit point.
265
290
 
266
291
 
267
292
  ## Artists
@@ -288,7 +313,7 @@ Params:
288
313
  Returns: _Array_ of Artists _Hash_
289
314
 
290
315
  ``` js
291
- // Example: GET /api/v2/artists?limit=14&api_key=1234567890abcdef
316
+ // Example: GET /api/v3/artists?limit=14&api_key=1234567890abcdef
292
317
 
293
318
  [
294
319
  {
@@ -299,13 +324,12 @@ Returns: _Array_ of Artists _Hash_
299
324
  "primary_genre_id": 61,
300
325
  "upcoming_events_count": 0,
301
326
  "updated_at": "2010-03-26T16:49:20Z",
302
- "photos":
303
- {
304
- "thumbnail": "http://i.tc-core.com/artist/_default/default-thumbnail.jpg",
305
- "medium": "http://i.tc-core.com/artist/_default/default-medium.jpg",
306
- "large": "http://i.tc-core.com/artist/_default/default-large.jpg",
307
- "mobile": "http://i.tc-core.com/artist/_default/default-mobile.jpg"
308
- },
327
+ "photos": {
328
+ "thumbnail": "http://i.development.tc-core.com/artist/_default/default-thumbnail.jpg",
329
+ "medium": "http://i.development.tc-core.com/artist/_default/default-medium.jpg",
330
+ "large": "http://i.development.tc-core.com/artist/_default/default-large.jpg",
331
+ "mobile": "http://i.development.tc-core.com/artist/_default/default-mobile.jpg"
332
+ },
309
333
  "url": "http://thrillcall.com/artist/Hyler_Jones_Proteges"
310
334
  },
311
335
  {
@@ -325,24 +349,23 @@ Params:
325
349
  Returns: Artist _Hash_
326
350
 
327
351
  ``` js
328
- // Example: GET /api/v2/artist/4802?api_key=1234567890abcdef
352
+ // Example: GET /api/v3/artist/378465?api_key=1234567890abcdef
329
353
 
330
354
  {
331
- "created_at": "2008-04-28T18:56:09Z",
332
- "genre_tags": "Rock",
333
- "id": 4802,
334
- "name": "The Sea and Cake",
335
- "primary_genre_id": 27,
336
- "upcoming_events_count": 8,
337
- "updated_at": "2011-09-20T19:12:57Z",
338
- "photos":
339
- {
340
- "thumbnail": "http://i.tc-core.com/artist/_default/default-thumbnail.jpg",
341
- "medium": "http://i.tc-core.com/artist/_default/default-medium.jpg",
342
- "large": "http://i.tc-core.com/artist/_default/default-large.jpg",
343
- "mobile": "http://i.tc-core.com/artist/_default/default-mobile.jpg"
344
- },
345
- "url": "http://thrillcall.com/artist/The_Sea_and_Cake"
355
+ "created_at": "2011-05-19T20:27:47Z",
356
+ "genre_tags": "Operatic pop",
357
+ "id": 378465,
358
+ "name": "Il Volo",
359
+ "primary_genre_id": 61,
360
+ "upcoming_events_count": 30,
361
+ "updated_at": "2012-03-27T15:59:04Z",
362
+ "photos": {
363
+ "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
364
+ "medium": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426",
365
+ "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
366
+ "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
367
+ },
368
+ "url": "http://thrillcall.com/artist/Il_Volo"
346
369
  }
347
370
  ```
348
371
 
@@ -353,8 +376,11 @@ Params:
353
376
 
354
377
  - **[limit](#limit)**
355
378
  - **[page](#page)**
379
+ - **[time\_zone](#time_zone)**
356
380
  - **[min\_date](#min_date)**
357
381
  - **[max\_date](#max_date)**
382
+ - **[min\_updated\_at](#min_updated_at)**
383
+ - **[max\_updated\_at](#max_updated_at)**
358
384
  - **[lat](#lat)**
359
385
  - **[long](#long)**
360
386
  - **[postalcode](#postalcode)**
@@ -362,40 +388,40 @@ Params:
362
388
  - **[use\_partner\_id](#use_partner_id)**
363
389
  - **[ticket\_type](#ticket_type)**
364
390
  - **[must\_have\_tickets](#must_have_tickets)**
391
+ - **[show\_disabled\_events](#show_disabled_events)**
365
392
  - **[show\_unconfirmed\_events](#show_unconfirmed_events)**
366
393
  - **[show\_rumor\_events](#show_rumor_events)**
367
394
 
368
395
  Returns: _Array_ of Events _Hash_
369
396
 
370
397
  ``` js
371
- // Example: GET /api/v2/artist/4802/events?api_key=1234567890abcdef
398
+ // Example: GET /api/v3/artist/378465/events?api_key=1234567890abcdef
372
399
 
373
400
  [
374
401
  {
375
- "created_at": "2011-06-23T23:10:31Z",
376
- "end_date": null,
402
+ "created_at": "2012-03-02T08:01:03Z",
377
403
  "festival": false,
378
- "id": 862618,
379
- "latitude": 30.2729,
380
- "longitude": -97.7405,
381
- "name": "The Sea and Cake @ The Mohawk",
382
- "num_cancelled_bookings": 0,
383
- "num_confirmed_bookings": 1,
384
- "num_disabled_bookings": 0,
385
- "num_unconfirmed_bookings": 0,
404
+ "id": 1046915,
405
+ "latitude": 47.6136,
406
+ "longitude": -122.332,
407
+ "name": "Il Volo @ Paramount Theatre - Seattle",
386
408
  "on_sale_date": null,
387
409
  "rumor": false,
388
- "start_date": "2011-12-09T05:59:00Z",
410
+ "start_date": "2012-10-02T19:30:00Z",
411
+ "starts_at": "2012-10-03T02:30:00Z",
412
+ "starts_at_time_trusted": true,
389
413
  "unconfirmed_location": 0,
390
- "updated_at": "2011-09-28T04:01:56Z",
391
- "venue_id": 10116,
392
- "photos":
393
- {
394
- "thumbnail": "http://i.tc-core.com/event/_default/default-thumbnail.jpg",
395
- "large": "http://i.tc-core.com/event/_default/default-large.jpg",
396
- "mobile": "http://i.tc-core.com/event/_default/default-mobile.jpg"
397
- },
398
- "url": "http://thrillcall.com/event/862618"
414
+ "updated_at": "2012-03-29T01:35:53Z",
415
+ "venue_id": 61705,
416
+ "photos": {
417
+ "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
418
+ "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
419
+ "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
420
+ },
421
+ "url": "http://thrillcall.com/event/1046915",
422
+ "starts_at_local": "2012-10-02T19:30:00-07:00",
423
+ "time_zone": "America/Los_Angeles",
424
+ "status": "confirmed"
399
425
  },
400
426
  {
401
427
  ...
@@ -415,25 +441,24 @@ Params:
415
441
  Returns: _Array_ of Artists _Hash_
416
442
 
417
443
  ``` js
418
- // Example: GET /api/v2/search/artists/The%20Sea%20and%20Cake?api_key=1234567890abcdef
444
+ // Example: GET /api/v3/search/artists/Il%20Volo?api_key=1234567890abcdef
419
445
 
420
446
  [
421
447
  {
422
- "created_at": "2008-04-28T18:56:09Z",
423
- "genre_tags": "Rock",
424
- "id": 4802,
425
- "name": "The Sea and Cake",
426
- "primary_genre_id": 27,
427
- "upcoming_events_count": 8,
428
- "updated_at": "2011-09-20T19:12:57Z",
429
- "photos":
430
- {
431
- "thumbnail": "http://i.tc-core.com/artist/_default/default-thumbnail.jpg",
432
- "medium": "http://i.tc-core.com/artist/_default/default-medium.jpg",
433
- "large": "http://i.tc-core.com/artist/_default/default-large.jpg",
434
- "mobile": "http://i.tc-core.com/artist/_default/default-mobile.jpg"
435
- },
436
- "url": "http://thrillcall.com/artist/The_Sea_and_Cake"
448
+ "created_at": "2011-05-19T20:27:47Z",
449
+ "genre_tags": "Operatic pop",
450
+ "id": 378465,
451
+ "name": "Il Volo",
452
+ "primary_genre_id": 61,
453
+ "upcoming_events_count": 30,
454
+ "updated_at": "2012-03-27T15:59:04Z",
455
+ "photos": {
456
+ "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
457
+ "medium": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426",
458
+ "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
459
+ "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
460
+ },
461
+ "url": "http://thrillcall.com/artist/Il_Volo"
437
462
  },
438
463
  {
439
464
  ...
@@ -446,20 +471,19 @@ Returns: _Array_ of Artists _Hash_
446
471
  Fields:
447
472
 
448
473
  - **created\_at** _string_ ISO 8601 representation the time this object was created
449
- - **end\_date** _string_ ISO 8601 representation of the end of the Event
450
474
  - **festival** _boolean_ Is this event a festival?
451
475
  - **id** _integer_ Thrillcall ID
452
476
  - **latitude** _float_ Approximate latitude for the Event
453
477
  - **longitude** _float_ Approximate longitude for the Event
454
478
  - **name** _string_ Name of the Event
455
- - **num\_confirmed\_bookings** _integer_ The number of confirmed Artist bookings for this event. Only Artists with a confirmed booking are returned when requesting artists for an event.
456
- - **num\_unconfirmed\_bookings** _integer_ The number of unconfirmed Artist bookings for this event
457
- - **num\_disabled\_bookings** _integer_ The number of disabled Artist bookings for this event
458
- - **num\_cancelled\_bookings** _integer_ The number of cancelled Artist bookings for this event
459
479
  - **on\_sale\_date** _string_ ISO 8601 representation of the date when tickets go on sale
460
480
  - **rumor** _boolean_ Are the details for this event based on a rumor?
461
- - **start\_date** _string_ YYYY-MM-DD or, if time of day is known, ISO 8601 representation of the start of the Event
462
- - **unconfirmed\_location** _integer_ If 1, the location if this event is unconfirmed
481
+ - **status** _string_ Status of the event (confirmed, unconfirmed, cancelled, or disabled)
482
+ - **starts\_at** _string_ ISO 8601 representation of the start of the Event in UTC time
483
+ - **starts\_at\_local** _string_ ISO 8601 representation of the start of the Event in the local timezone
484
+ - **starts\_at\_time\_trusted** _boolean_ Do we trust that the time of day component of **starts\_at** is valid?
485
+ - **time\_zone** _string_ TZ Database string representing the time zone at the location of the event
486
+ - **unconfirmed\_location** _integer_ If 1, the location of this event is unconfirmed
463
487
  - **updated\_at** _string_ ISO 8601 representation of last time this object was updated
464
488
  - **venue\_id** _integer_ Thrillcall Venue ID
465
489
  - **photos** _hash_ A hash of image urls of the primary photo available for this object in different styles
@@ -471,48 +495,51 @@ Params:
471
495
 
472
496
  - **[limit](#limit)**
473
497
  - **[page](#page)**
498
+ - **[time\_zone](#time_zone)**
474
499
  - **[min\_date](#min_date)**
475
500
  - **[max\_date](#max_date)**
501
+ - **[min\_updated\_at](#min_updated_at)**
502
+ - **[max\_updated\_at](#max_updated_at)**
476
503
  - **[lat](#lat)**
477
504
  - **[long](#long)**
478
505
  - **[postalcode](#postalcode)**
479
506
  - **[radius](#radius)**
480
507
  - **[ticket\_type](#ticket_type)**
481
508
  - **[must\_have\_tickets](#must_have_tickets)**
509
+ - **[show\_disabled\_events](#show_disabled_events)**
482
510
  - **[show\_unconfirmed\_events](#show_unconfirmed_events)**
483
511
  - **[show\_rumor\_events](#show_rumor_events)**
484
512
 
485
513
  Returns: _Array_ of Events _Hash_
486
514
 
487
515
  ``` js
488
- // Example: GET /api/v2/events?must_have_tickets=true&postalcode=94108&radius=10&limit=3&api_key=1234567890abcdef
516
+ // Example: GET /api/v3/events?must_have_tickets=true&postalcode=94108&radius=10&limit=3&api_key=1234567890abcdef
489
517
 
490
518
  [
491
519
  {
492
- "created_at": "2011-06-14T00:09:13Z",
493
- "end_date": null,
520
+ "created_at": "2012-03-02T18:06:14Z",
494
521
  "festival": false,
495
- "id": 858707,
496
- "latitude": 37.7951,
497
- "longitude": -122.421,
498
- "name": "The Sea and Cake @ Great American Music Hall",
499
- "num_cancelled_bookings": 0,
500
- "num_confirmed_bookings": 1,
501
- "num_disabled_bookings": 0,
502
- "num_unconfirmed_bookings": 0,
522
+ "id": 1047075,
523
+ "latitude": 37.7915,
524
+ "longitude": -122.413,
525
+ "name": "Il Volo @ Masonic Center",
503
526
  "on_sale_date": null,
504
527
  "rumor": false,
505
- "start_date": "2011-12-06T07:59:00Z",
528
+ "start_date": "2012-09-29T19:30:04Z",
529
+ "starts_at": "2012-09-30T02:30:04Z",
530
+ "starts_at_time_trusted": true,
506
531
  "unconfirmed_location": 0,
507
- "updated_at": "2011-09-28T04:00:41Z",
508
- "venue_id": 27418,
509
- "photos":
510
- {
511
- "thumbnail": "http://i.tc-core.com/event/_default/default-thumbnail.jpg",
512
- "large": "http://i.tc-core.com/event/_default/default-large.jpg",
513
- "mobile": "http://i.tc-core.com/event/_default/default-mobile.jpg"
514
- },
515
- "url": "http://thrillcall.com/event/858707"
532
+ "updated_at": "2012-03-29T01:35:57Z",
533
+ "venue_id": 63279,
534
+ "photos": {
535
+ "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
536
+ "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
537
+ "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
538
+ },
539
+ "url": "http://thrillcall.com/event/1047075",
540
+ "starts_at_local": "2012-09-29T19:30:04-07:00",
541
+ "time_zone": "America/Los_Angeles"
542
+ "status": "confirmed"
516
543
  },
517
544
  {
518
545
  ...
@@ -531,33 +558,33 @@ Params:
531
558
  Returns: Event _Hash_
532
559
 
533
560
  ``` js
534
- // Example: GET /api/v2/event/858707?api_key=1234567890abcdef
561
+ // Example: GET /api/v3/event/1045602/venue?api_key=1234567890abcdef
535
562
 
536
563
  {
537
- "created_at": "2011-06-14T00:09:13Z",
538
- "end_date": null,
539
- "festival": false,
540
- "id": 858707,
541
- "latitude": 37.7951,
542
- "longitude": -122.421,
543
- "name": "The Sea and Cake @ Great American Music Hall",
544
- "num_cancelled_bookings": 0,
545
- "num_confirmed_bookings": 1,
546
- "num_disabled_bookings": 0,
547
- "num_unconfirmed_bookings": 0,
548
- "on_sale_date": null,
549
- "rumor": false,
550
- "start_date": "2011-12-06T07:59:00Z",
551
- "unconfirmed_location": 0,
552
- "updated_at": "2011-09-28T04:00:41Z",
553
- "venue_id": 27418,
554
- "photos":
555
- {
556
- "thumbnail": "http://i.tc-core.com/event/_default/default-thumbnail.jpg",
557
- "large": "http://i.tc-core.com/event/_default/default-large.jpg",
558
- "mobile": "http://i.tc-core.com/event/_default/default-mobile.jpg"
559
- },
560
- "url": "http://thrillcall.com/event/858707"
564
+ "address1": "1111 California Street",
565
+ "address2": null,
566
+ "city": "San Francisco",
567
+ "country": "US",
568
+ "created_at": "2009-08-25T19:25:27Z",
569
+ "id": 63279,
570
+ "latitude": 37.79153,
571
+ "long_description": null,
572
+ "longitude": -122.412757,
573
+ "name": "Masonic Center",
574
+ "phone_number": null,
575
+ "state": "CA",
576
+ "time_zone": "America/Los_Angeles",
577
+ "upcoming_events_count": 4,
578
+ "updated_at": "2012-04-04T02:08:50Z",
579
+ "postalcode": "94108",
580
+ "photos": {
581
+ "thumbnail": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135",
582
+ "medium": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135",
583
+ "large": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135",
584
+ "mobile": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"
585
+ },
586
+ "metro_area_id": 105,
587
+ "url": "http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"
561
588
  }
562
589
  ```
563
590
 
@@ -572,25 +599,24 @@ Params:
572
599
  Returns: _Array_ of Artists _Hash_
573
600
 
574
601
  ``` js
575
- // Example: GET /api/v2/event/858707/artists?api_key=1234567890abcdef
602
+ // Example: GET /api/v3/event/1047075/artists?api_key=1234567890abcdef
576
603
 
577
604
  [
578
605
  {
579
- "created_at": "2008-04-28T18:56:09Z",
580
- "genre_tags": "Rock",
581
- "id": 4802,
582
- "name": "The Sea and Cake",
583
- "primary_genre_id": 27,
584
- "upcoming_events_count": 8,
585
- "updated_at": "2011-09-20T19:12:57Z",
586
- "photos":
587
- {
588
- "thumbnail": "http://i.tc-core.com/artist/_default/default-thumbnail.jpg",
589
- "medium": "http://i.tc-core.com/artist/_default/default-medium.jpg",
590
- "large": "http://i.tc-core.com/artist/_default/default-large.jpg",
591
- "mobile": "http://i.tc-core.com/artist/_default/default-mobile.jpg"
592
- },
593
- "url": "http://thrillcall.com/artist/The_Sea_and_Cake"
606
+ "created_at": "2011-05-19T20:27:47Z",
607
+ "genre_tags": "Operatic pop",
608
+ "id": 378465,
609
+ "name": "Il Volo",
610
+ "primary_genre_id": 61,
611
+ "upcoming_events_count": 30,
612
+ "updated_at": "2012-03-27T15:59:04Z",
613
+ "photos": {
614
+ "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
615
+ "medium": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426",
616
+ "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
617
+ "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
618
+ },
619
+ "url": "http://thrillcall.com/artist/Il_Volo"
594
620
  },
595
621
  {
596
622
  ...
@@ -609,31 +635,33 @@ Params:
609
635
  Returns: Venue _Hash_
610
636
 
611
637
  ``` js
612
- // Example: GET /api/v2/event/858707/venue?api_key=1234567890abcdef
638
+ // Example: GET /api/v3/event/1045602/venue?api_key=1234567890abcdef
613
639
 
614
640
  {
615
- "address1": "859 O'Farrell St.",
641
+ "address1": "1111 California Street",
616
642
  "address2": null,
617
643
  "city": "San Francisco",
618
644
  "country": "US",
619
- "created_at": "2008-04-21T16:52:31Z",
620
- "id": 27418,
621
- "latitude": 37.784796,
622
- "longitude": -122.418819,
623
- "name": "Great American Music Hall",
645
+ "created_at": "2009-08-25T19:25:27Z",
646
+ "id": 63279,
647
+ "latitude": 37.79153,
648
+ "long_description": null,
649
+ "longitude": -122.412757,
650
+ "name": "Masonic Center",
651
+ "phone_number": null,
624
652
  "state": "CA",
625
- "upcoming_events_count": 34,
626
- "updated_at": "2011-01-20T21:04:37Z",
627
- "postalcode": "94109",
653
+ "time_zone": "America/Los_Angeles",
654
+ "upcoming_events_count": 4,
655
+ "updated_at": "2012-04-04T02:08:50Z",
656
+ "postalcode": "94108",
657
+ "photos": {
658
+ "thumbnail": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135",
659
+ "medium": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135",
660
+ "large": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135",
661
+ "mobile": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"
662
+ },
628
663
  "metro_area_id": 105,
629
- "photos":
630
- {
631
- "thumbnail": "http://i.tc-core.com/venue/_default/default-thumbnail.jpg",
632
- "medium": "http://i.tc-core.com/venue/_default/default-medium.jpg",
633
- "large": "http://i.tc-core.com/venue/_default/default-large.jpg",
634
- "mobile": "http://i.tc-core.com/venue/_default/default-mobile.jpg"
635
- }
636
- "url": "http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"
664
+ "url": "http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"
637
665
  }
638
666
  ```
639
667
 
@@ -649,23 +677,23 @@ Params:
649
677
  Returns: _Array_ of Tickets _Hash_
650
678
 
651
679
  ``` js
652
- // Example: GET /api/v2/event/858707/tickets?api_key=1234567890abcdef
680
+ // Example: GET /api/v3/event/1047075/tickets?api_key=1234567890abcdef
653
681
 
654
682
  [
655
683
  {
656
- "created_at": "2011-06-14T00:09:16Z",
684
+ "created_at": "2012-03-02T18:06:14Z",
657
685
  "description": null,
658
- "event_id": 858707,
659
- "id": 599794,
686
+ "event_id": 1047075,
687
+ "id": 819883,
660
688
  "marketing_text": null,
661
- "max_ticket_price": 21,
662
- "min_ticket_price": null,
663
- "name": "Gen. Admission Seating Limited",
689
+ "max_ticket_price": 85,
690
+ "min_ticket_price": 29,
691
+ "name": "Onsale to General Public",
664
692
  "on_sale_end_date": null,
665
693
  "on_sale_start_date": null,
666
694
  "seat_info": null,
667
- "updated_at": "2011-06-14T00:09:16Z",
668
- "url": "http://tickets.gamh.com/evinfo.php?eventid=154723&amp;r=affi&amp;u=210785"
695
+ "updated_at": "2012-03-02T18:06:14Z",
696
+ "url": "http://ticketsus.at/thrillcall?CTY=39&DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&brand=[=BRAND=]"
669
697
  },
670
698
  {
671
699
  ...
@@ -692,7 +720,7 @@ Params:
692
720
  Returns: _Array_ of Genres _Hash_
693
721
 
694
722
  ``` js
695
- // Example: GET /api/v2/genres?limit=14&api_key=1234567890abcdef
723
+ // Example: GET /api/v3/genres?limit=14&api_key=1234567890abcdef
696
724
 
697
725
  [
698
726
  {
@@ -719,7 +747,7 @@ Params:
719
747
  Returns: Genre _Hash_
720
748
 
721
749
  ``` js
722
- // Example: GET /api/v2/genre/27?api_key=1234567890abcdef
750
+ // Example: GET /api/v3/genre/27?api_key=1234567890abcdef
723
751
 
724
752
  {
725
753
  "created_at": "2008-07-09T19:17:45Z",
@@ -741,25 +769,24 @@ Params:
741
769
  Returns: _Array_ of Artists _Hash_
742
770
 
743
771
  ``` js
744
- // Example: GET /api/v2/genre/27/artists?api_key=1234567890abcdef
772
+ // Example: GET /api/v3/genre/61/artists?api_key=1234567890abcdef
745
773
 
746
774
  [
747
775
  {
748
- "created_at": "2008-04-29T10:06:05Z",
749
- "genre_tags": "Folk;Other;psychedelic",
750
- "id": 2,
751
- "name": "Espers",
752
- "primary_genre_id": 27,
753
- "upcoming_events_count": 1,
754
- "updated_at": "2011-01-03T22:14:36Z",
755
- "photos":
756
- {
757
- "thumbnail": "http://i.tc-core.com/artist/_default/default-thumbnail.jpg",
758
- "medium": "http://i.tc-core.com/artist/_default/default-medium.jpg",
759
- "large": "http://i.tc-core.com/artist/_default/default-large.jpg",
760
- "mobile": "http://i.tc-core.com/artist/_default/default-mobile.jpg"
761
- },
762
- "url": "http://thrillcall.com/artist/Espers"
776
+ "created_at": "2008-04-29T10:19:45Z",
777
+ "genre_tags": "O",
778
+ "id": 1,
779
+ "name": "Hyler Jones Proteges",
780
+ "primary_genre_id": 61,
781
+ "upcoming_events_count": 0,
782
+ "updated_at": "2010-03-26T16:49:20Z",
783
+ "photos": {
784
+ "thumbnail": "http://i.development.tc-core.com/artist/_default/default-thumbnail.jpg",
785
+ "medium": "http://i.development.tc-core.com/artist/_default/default-medium.jpg",
786
+ "large": "http://i.development.tc-core.com/artist/_default/default-large.jpg",
787
+ "mobile": "http://i.development.tc-core.com/artist/_default/default-mobile.jpg"
788
+ },
789
+ "url": "http://thrillcall.com/artist/Hyler_Jones_Proteges"
763
790
  },
764
791
  {
765
792
  ...
@@ -771,17 +798,18 @@ Returns: _Array_ of Artists _Hash_
771
798
  ## Metro Area
772
799
  Fields:
773
800
 
774
- - **city** _string_ City of the Metro Area
775
- - **country** _string_ Country of the Metro Area
776
- - **created\_at** _string_ ISO 8601 representation the time this object was created
777
- - **id** _integer_ Thrillcall ID
778
- - **latitude** _float_ Latitude of the Metro Area
779
- - **longitude** _float_ Longitude of the Metro Area
780
- - **radius** _integer_ Radius of the Metro Area from the Lat/Long center
781
- - **state** _string_ State of the Metro Area
782
- - **time\_zone** _string_ Time zone of the Metro Area
783
- - **updated\_at** _string_ ISO 8601 representation of last time this object was updated
784
- - **url** _string_ URL for this object on Thrillcall
801
+ - **city** _string_ City of the Metro Area
802
+ - **country** _string_ Country of the Metro Area
803
+ - **created\_at** _string_ ISO 8601 representation the time this object was created
804
+ - **id** _integer_ Thrillcall ID
805
+ - **latitude** _float_ Latitude of the Metro Area
806
+ - **longitude** _float_ Longitude of the Metro Area
807
+ - **radius** _integer_ Radius of the Metro Area from the Lat/Long center
808
+ - **state** _string_ State of the Metro Area
809
+ - **time\_zone** _string_ Time zone of the Metro Area
810
+ - **updated\_at** _string_ ISO 8601 representation of last time this object was updated
811
+ - **url** _string_ URL for this object on Thrillcall
812
+ - **offers\_availability\_status\_code** _integer_ Offers status for the Metro Area ( no\_offers = 0, available = 1, coming\_soon = 2)
785
813
 
786
814
  ### GET /metro_areas
787
815
  Params:
@@ -792,7 +820,7 @@ Params:
792
820
  Returns: _Array_ of Metro Areas _Hash_
793
821
 
794
822
  ``` js
795
- // Example: GET /api/v2/metro_areas?limit=14&api_key=1234567890abcdef
823
+ // Example: GET /api/v3/metro_areas?limit=14&api_key=1234567890abcdef
796
824
 
797
825
  [
798
826
  {
@@ -802,10 +830,11 @@ Returns: _Array_ of Metro Areas _Hash_
802
830
  "id": 104,
803
831
  "latitude": 41.8842,
804
832
  "longitude": -87.6324,
833
+ "offers_availability_status_code": 1,
805
834
  "radius": 50,
806
835
  "state": "IL",
807
836
  "time_zone": "America/Chicago",
808
- "updated_at": "2011-07-05T23:11:24Z",
837
+ "updated_at": "2011-12-27T00:44:37Z",
809
838
  "url": "http://thrillcall.com/live-music/chicago"
810
839
  },
811
840
  {
@@ -825,7 +854,7 @@ Params:
825
854
  Returns: Metro Area _Hash_
826
855
 
827
856
  ``` js
828
- // Example: GET /api/v2/metro_area/105?api_key=1234567890abcdef
857
+ // Example: GET /api/v3/metro_area/105?api_key=1234567890abcdef
829
858
 
830
859
  {
831
860
  "city": "San Francisco",
@@ -834,10 +863,11 @@ Returns: Metro Area _Hash_
834
863
  "id": 105,
835
864
  "latitude": 37.7771,
836
865
  "longitude": -122.42,
866
+ "offers_availability_status_code": 1,
837
867
  "radius": 50,
838
868
  "state": "CA",
839
- "time_zone": "America/Chicago",
840
- "updated_at": "2011-07-05T23:11:24Z",
869
+ "time_zone": "America/Los_Angeles",
870
+ "updated_at": "2011-12-27T00:44:37Z",
841
871
  "url": "http://thrillcall.com/live-music/san-francisco"
842
872
  }
843
873
  ```
@@ -851,43 +881,47 @@ Params:
851
881
  - **[page](#page)**
852
882
  - **[min\_date](#min_date)**
853
883
  - **[max\_date](#max_date)**
884
+ - **[min\_updated\_at](#min_updated_at)**
885
+ - **[max\_updated\_at](#max_updated_at)**
854
886
  - **[radius](#radius)**
855
887
  - **[ticket\_type](#ticket_type)**
856
888
  - **[must\_have\_tickets](#must_have_tickets)**
889
+ - **[show\_disabled\_events](#show_disabled_events)**
857
890
  - **[show\_unconfirmed\_events](#show_unconfirmed_events)**
858
891
  - **[show\_rumor\_events](#show_rumor_events)**
859
892
 
893
+ Note: Time Zone is set as the time zone of the Metro Area and cannot be overridden.
894
+
860
895
  Returns: _Array_ of Metro Areas _Hash_
861
896
 
862
897
  ``` js
863
- // Example: GET /api/v2/metro_area/105/events?api_key=1234567890abcdef
898
+ // Example: GET /api/v3/metro_area/105/events?min_date=2011-04-05&max_date=2012-04-04&limit=3&api_key=1234567890abcdef
864
899
 
865
900
  [
866
901
  {
867
- "created_at": "2011-04-24T02:12:09Z",
868
- "end_date": null,
902
+ "created_at": "2012-01-02T08:53:00Z",
869
903
  "festival": false,
870
- "id": 831330,
871
- "latitude": 37.7794,
872
- "longitude": -122.418,
873
- "name": "Philadelphia Orchestra @ Davies Symphony Hall",
874
- "num_cancelled_bookings": 0,
875
- "num_confirmed_bookings": 1,
876
- "num_disabled_bookings": 0,
877
- "num_unconfirmed_bookings": 0,
904
+ "id": 1011386,
905
+ "latitude": 37.7771,
906
+ "longitude": -122.42,
907
+ "name": "Kontrol @ The End Up",
878
908
  "on_sale_date": null,
879
909
  "rumor": false,
880
- "start_date": "2012-06-11T06:59:00Z",
910
+ "start_date": "2012-01-07T00:00:04Z",
911
+ "starts_at": "2012-01-07T08:00:04Z",
912
+ "starts_at_time_trusted": false,
881
913
  "unconfirmed_location": 0,
882
- "updated_at": "2011-09-28T03:51:22Z",
883
- "venue_id": 51886,
884
- "photos":
885
- {
886
- "thumbnail": "http://i.tc-core.com/event/_default/default-thumbnail.jpg",
887
- "large": "http://i.tc-core.com/event/_default/default-large.jpg",
888
- "mobile": "http://i.tc-core.com/event/_default/default-mobile.jpg"
889
- },
890
- "url": "http://thrillcall.com/event/831330"
914
+ "updated_at": "2012-03-29T01:19:31Z",
915
+ "venue_id": 47273,
916
+ "photos": {
917
+ "thumbnail": "http://i.development.tc-core.com/event/_default/default-thumbnail.jpg",
918
+ "large": "http://i.development.tc-core.com/event/_default/default-large.jpg",
919
+ "mobile": "http://i.development.tc-core.com/dan/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-mobile.jpg?1326489566"
920
+ },
921
+ "url": "http://thrillcall.com/event/1011386",
922
+ "starts_at_local": "2012-01-07T00:00:04-08:00",
923
+ "time_zone": "America/Los_Angeles"
924
+ "status": "confirmed"
891
925
  },
892
926
  {
893
927
  ...
@@ -909,10 +943,46 @@ Fields:
909
943
  - **login** _string_ Login (Email Address) of the Person
910
944
  - **updated\_at** _string_ ISO 8601 representation of last time this object was updated
911
945
  - **referral\_code** _string_ Referral code of the Person
912
- - **referral\_code\_count** _integer_ Number of Referral code used for the Person
946
+ - **referral\_credits** _integer_ Number of Referral credits the Person has (including bonus points)
913
947
  - **postalcode** _string_ Postalcode of the Person
914
948
  - **photos** _hash_ A hash of image urls of the primary photo available for this object in different styles
915
949
 
950
+ ### GET /person/:id
951
+ Params:
952
+
953
+ - None.
954
+
955
+ Returns: Person _Hash_
956
+
957
+ ``` js
958
+ // Example: GET /api/v3/person/49?api_key=1234567890abcdef
959
+
960
+ {
961
+ "address1": null,
962
+ "address2": null,
963
+ "city": "Santa Rosa",
964
+ "country_code": "US",
965
+ "created_at": "2011-10-17T18:54:31Z",
966
+ "first_name": "John",
967
+ "gender": "m",
968
+ "id": 49,
969
+ "last_name": "Doe",
970
+ "login": "bogus@bogus.com",
971
+ "state": "CA",
972
+ "time_zone": "America/Los_Angeles",
973
+ "timezone": "-7",
974
+ "updated_at": "2012-03-28T16:07:16Z",
975
+ "referral_code": null,
976
+ "referral_credits": 0,
977
+ "postalcode": "95407",
978
+ "photos": {
979
+ "small_thumb": "http://i.development.tc-core.com/dan/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
980
+ "thumbnail": "http://i.development.tc-core.com/dan/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
981
+ "medium": "http://i.development.tc-core.com/dan/person/164761/1324568419/19154-medium.jpg?1324568419"
982
+ }
983
+ }
984
+ ```
985
+
916
986
  ### POST /person/signin
917
987
  Params:
918
988
 
@@ -935,25 +1005,30 @@ May perform registration ("signup") automatically if using **[provider](#provide
935
1005
  Returns: Person _Hash_
936
1006
 
937
1007
  ``` js
938
- // Example: POST /api/v2/person/signin
1008
+ // Example: POST /api/v3/person/signin?provider=facebook&uid=123123bogus&token=123123bogus&email=123123bogus%40bogus.com&first_name=Mister&last_name=Bogus&lat=38.5&long=-123.0&api_key=1234567890abcdef
939
1009
 
940
1010
  {
941
- "created_at": "2000-11-09T19:09:23Z",
942
- "first_name": "John",
1011
+ "address1": null,
1012
+ "address2": null,
1013
+ "city": null,
1014
+ "country_code": null,
1015
+ "created_at": null,
1016
+ "first_name": "Mister",
943
1017
  "gender": null,
944
- "id": 49,
945
- "last_name": "Doe",
946
- "login": "john@example.com",
947
- "updated_at": "2011-11-09T19:09:23Z",
948
- "referral_code": "fhskjfhk3j43h43hjkh",
949
- "referral_code_count": 0,
950
- "photos":
951
- {
952
- "small_thumb": "http://i.tc-core.com/person/_default/default-small_thumb.jpg",
953
- "thumbnail": "http://i.tc-core.com/person/_default/default-thumbnail.jpg",
954
- "medium": "http://i.tc-core.com/person/_default/default-medium.jpg"
955
- },
956
- "postalcode": "94104"
1018
+ "last_name": "Bogus",
1019
+ "login": null,
1020
+ "state": null,
1021
+ "time_zone": null,
1022
+ "timezone": null,
1023
+ "updated_at": null,
1024
+ "referral_code": null,
1025
+ "referral_credits": 0,
1026
+ "postalcode": null,
1027
+ "photos": {
1028
+ "small_thumb": "http://i.development.tc-core.com/person/_default/default-small_thumb.jpg",
1029
+ "thumbnail": "http://i.development.tc-core.com/person/_default/default-thumbnail.jpg",
1030
+ "medium": "http://i.development.tc-core.com/person/_default/default-medium.jpg"
1031
+ }
957
1032
  }
958
1033
  ```
959
1034
 
@@ -971,26 +1046,31 @@ Params:
971
1046
  Returns: Person _Hash_
972
1047
 
973
1048
  ``` js
974
- // Example: POST /api/v2/person/signup
1049
+ // Example: POST /api/v3/person/signup?first_name=Mister&email=bogus%40bogus.com&password=bogus&postalcode=94108&api_key=1234567890abcdef
975
1050
 
976
1051
  {
977
- "created_at": "2000-11-09T19:09:23Z",
978
- "first_name": "John",
979
- "gender": null,
980
- "id": 49,
981
- "last_name": "Doe",
982
- "login": "john@example.com",
983
- "updated_at": "2011-11-09T19:09:23Z",
984
- "referral_code": "fhskjfhk3j43h43hjkh",
985
- "referral_code_count": 0,
986
- "photos":
987
- {
988
- "small_thumb": "http://i.tc-core.com/person/_default/default-small_thumb.jpg",
989
- "thumbnail": "http://i.tc-core.com/person/_default/default-thumbnail.jpg",
990
- "medium": "http://i.tc-core.com/person/_default/default-medium.jpg"
991
- },
992
- "postalcode": "94104"
993
- }
1052
+ "address1": null,
1053
+ "address2": null,
1054
+ "city": null,
1055
+ "country_code": null,
1056
+ "created_at": null,
1057
+ "first_name": "Mister",
1058
+ "gender": null,
1059
+ "last_name": null,
1060
+ "login": null,
1061
+ "state": null,
1062
+ "time_zone": null,
1063
+ "timezone": null,
1064
+ "updated_at": null,
1065
+ "referral_code": null,
1066
+ "referral_credits": 0,
1067
+ "postalcode": null,
1068
+ "photos": {
1069
+ "small_thumb": "http://i.development.tc-core.com/person/_default/default-small_thumb.jpg",
1070
+ "thumbnail": "http://i.development.tc-core.com/person/_default/default-thumbnail.jpg",
1071
+ "medium": "http://i.development.tc-core.com/person/_default/default-medium.jpg"
1072
+ }
1073
+ }
994
1074
  ```
995
1075
 
996
1076
 
@@ -1012,6 +1092,7 @@ Fields:
1012
1092
  - **upcoming\_events\_count** _integer_ Number of upcoming events associated with this object
1013
1093
  - **updated\_at** _string_ ISO 8601 representation of last time this object was updated
1014
1094
  - **postalcode** _string_ Postal code for the Venue
1095
+ - **phone\_number** _string_ Phone number for the Venue (including country code)
1015
1096
  - **photos** _hash_ A hash of image urls of the primary photo available for this object in different styles
1016
1097
  - **url** _string_ URL for this object on Thrillcall
1017
1098
 
@@ -1029,7 +1110,7 @@ Params:
1029
1110
  Returns: _Array_ of Venues _Hash_
1030
1111
 
1031
1112
  ``` js
1032
- // Example: GET /api/v2/venues?limit=14&api_key=1234567890abcdef
1113
+ // Example: GET /api/v3/venues?limit=14&api_key=1234567890abcdef
1033
1114
 
1034
1115
  [
1035
1116
  {
@@ -1037,23 +1118,25 @@ Returns: _Array_ of Venues _Hash_
1037
1118
  "address2": null,
1038
1119
  "city": "Guadalajara",
1039
1120
  "country": "MX",
1040
- "created_at": "2000-11-09T19:09:23Z",
1121
+ "created_at": "2008-05-09T09:29:23Z",
1041
1122
  "id": 1,
1042
- "latitude": null,
1043
- "long_description": "Description of the venue",
1044
- "longitude": null,
1123
+ "latitude": 20.666222,
1124
+ "long_description": null,
1125
+ "longitude": -103.352089,
1045
1126
  "name": "Fbolko",
1127
+ "phone_number": null,
1046
1128
  "state": "MX",
1129
+ "time_zone": "America/Mexico_City",
1047
1130
  "upcoming_events_count": 0,
1048
- "updated_at": "2010-03-28T17:24:20Z",
1131
+ "updated_at": "2012-03-29T00:04:23Z",
1049
1132
  "postalcode": null,
1050
- "photos":
1051
- {
1052
- "thumbnail": "http://i.tc-core.com/venue/_default/default-thumbnail.jpg",
1053
- "medium": "http://i.tc-core.com/venue/_default/default-medium.jpg",
1054
- "large": "http://i.tc-core.com/venue/_default/default-large.jpg",
1055
- "mobile": "http://i.tc-core.com/venue/_default/default-mobile.jpg"
1056
- }
1133
+ "photos": {
1134
+ "thumbnail": "http://i.development.tc-core.com/venue/_default/default-thumbnail.jpg",
1135
+ "medium": "http://i.development.tc-core.com/venue/_default/default-medium.jpg",
1136
+ "large": "http://i.development.tc-core.com/venue/_default/default-large.jpg",
1137
+ "mobile": "http://i.development.tc-core.com/venue/_default/default-mobile.jpg"
1138
+ },
1139
+ "metro_area_id": null,
1057
1140
  "url": "http://thrillcall.com/venue/Fbolko_in_Guadalajara_MX"
1058
1141
  },
1059
1142
  {
@@ -1074,32 +1157,33 @@ Params:
1074
1157
  Returns: Venue _Hash_
1075
1158
 
1076
1159
  ``` js
1077
- // Example: GET /api/v2/venue/27418?api_key=1234567890abcdef
1160
+ // Example: GET /api/v3/venue/51886?api_key=1234567890abcdef
1078
1161
 
1079
1162
  {
1080
- "address1": "859 O'Farrell St.",
1163
+ "address1": "201 Van Ness Avenue",
1081
1164
  "address2": null,
1082
1165
  "city": "San Francisco",
1083
1166
  "country": "US",
1084
- "created_at": "2008-04-21T16:52:31Z",
1085
- "id": 27418,
1086
- "latitude": 37.784796,
1087
- "long_description": "Description of the venue",
1088
- "longitude": -122.418819,
1089
- "name": "Great American Music Hall",
1167
+ "created_at": "2008-04-28T17:59:32Z",
1168
+ "id": 51886,
1169
+ "latitude": 37.777402,
1170
+ "long_description": null,
1171
+ "longitude": -122.419815,
1172
+ "name": "Davies Symphony Hall",
1173
+ "phone_number": "(415) 864-6000",
1090
1174
  "state": "CA",
1091
- "upcoming_events_count": 34,
1092
- "updated_at": "2011-01-20T21:04:37Z",
1093
- "postalcode": "94109",
1175
+ "time_zone": "America/Los_Angeles",
1176
+ "upcoming_events_count": 48,
1177
+ "updated_at": "2012-03-28T03:13:27Z",
1178
+ "postalcode": "94102",
1179
+ "photos": {
1180
+ "thumbnail": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-thumbnail.jpg?1326417154",
1181
+ "medium": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-medium.jpg?1326417154",
1182
+ "large": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-large.jpg?1326417154",
1183
+ "mobile": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-mobile.jpg?1326417154"
1184
+ },
1094
1185
  "metro_area_id": 105,
1095
- "photos":
1096
- {
1097
- "thumbnail": "http://i.tc-core.com/venue/_default/default-thumbnail.jpg",
1098
- "medium": "http://i.tc-core.com/venue/_default/default-medium.jpg",
1099
- "large": "http://i.tc-core.com/venue/_default/default-large.jpg",
1100
- "mobile": "http://i.tc-core.com/venue/_default/default-mobile.jpg"
1101
- }
1102
- "url": "http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"
1186
+ "url": "http://thrillcall.com/venue/Davies_Symphony_Hall_in_San_Francisco_CA"
1103
1187
  }
1104
1188
  ```
1105
1189
 
@@ -1110,42 +1194,48 @@ Params:
1110
1194
 
1111
1195
  - **[limit](#limit)**
1112
1196
  - **[page](#page)**
1197
+ - **[time\_zone](#time_zone)**
1113
1198
  - **[min\_date](#min_date)**
1114
1199
  - **[max\_date](#max_date)**
1200
+ - **[min\_updated\_at](#min_updated_at)**
1201
+ - **[max\_updated\_at](#max_updated_at)**
1115
1202
  - **[use\_partner\_id](#use_partner_id)**
1116
1203
  - **[ticket\_type](#ticket_type)**
1117
1204
  - **[must\_have\_tickets](#must_have_tickets)**
1205
+ - **[show\_disabled\_events](#show_disabled_events)**
1118
1206
  - **[show\_unconfirmed\_events](#show_unconfirmed_events)**
1119
1207
  - **[show\_rumor\_events](#show_rumor_events)**
1120
1208
 
1121
1209
  Returns: _Array_ of Events _Hash_
1122
1210
 
1123
1211
  ``` js
1124
- // Example: GET /api/v2/venue/32065/events?api_key=1234567890abcdef
1212
+ // Example: GET /api/v3/venue/63279/events?api_key=1234567890abcdef
1125
1213
 
1126
1214
  [
1127
1215
  {
1128
- "created_at": "2000-11-09T19:09:23Z",
1129
- "end_date": null,
1216
+ "created_at": "2012-03-02T18:06:14Z",
1130
1217
  "festival": false,
1131
- "id": 824614,
1132
- "latitude": 37.8016,
1133
- "long_description": "Description of the venue",
1134
- "longitude": -80.4462,
1135
- "name": "Colt Ford @ West Virginia State Fair",
1218
+ "id": 1047075,
1219
+ "latitude": 37.7915,
1220
+ "longitude": -122.413,
1221
+ "name": "Il Volo @ Masonic Center",
1136
1222
  "on_sale_date": null,
1137
1223
  "rumor": false,
1138
- "start_date": "2011-08-21T03:59:00Z",
1224
+ "start_date": "2012-09-29T19:30:04Z",
1225
+ "starts_at": "2012-09-30T02:30:04Z",
1226
+ "starts_at_time_trusted": true,
1139
1227
  "unconfirmed_location": 0,
1140
- "updated_at": "2011-06-24T05:10:05Z",
1141
- "venue_id": 32065,
1142
- "photos":
1143
- {
1144
- "thumbnail": "http://i.tc-core.com/event/_default/default-thumbnail.jpg",
1145
- "large": "http://i.tc-core.com/event/_default/default-large.jpg",
1146
- "mobile": "http://i.tc-core.com/event/_default/default-mobile.jpg"
1147
- },
1148
- "url": "http://thrillcall.com/event/824614"
1228
+ "updated_at": "2012-03-29T01:35:57Z",
1229
+ "venue_id": 63279,
1230
+ "photos": {
1231
+ "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
1232
+ "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
1233
+ "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
1234
+ },
1235
+ "url": "http://thrillcall.com/event/1047075",
1236
+ "starts_at_local": "2012-09-29T19:30:04-07:00",
1237
+ "time_zone": "America/Los_Angeles"
1238
+ "status": "confirmed"
1149
1239
  },
1150
1240
  {
1151
1241
  ...
@@ -1169,33 +1259,34 @@ Params:
1169
1259
  Returns: _Array_ of Venues _Hash_
1170
1260
 
1171
1261
  ``` js
1172
- // Example: GET /api/v2/search/venues/Great%20American%20Music%20Hall?api_key=1234567890abcdef
1262
+ // Example: GET /api/v3/search/venues/Masonic%20Center?api_key=1234567890abcdef
1173
1263
 
1174
1264
  [
1175
1265
  {
1176
- "address1": "859 O'Farrell St.",
1266
+ "address1": "525 W Riverview Ave",
1177
1267
  "address2": null,
1178
- "city": "San Francisco",
1268
+ "city": "Dayton",
1179
1269
  "country": "US",
1180
- "created_at": "2008-04-21T16:52:31Z",
1181
- "id": 27418,
1182
- "latitude": 37.784796,
1183
- "long_description": "Description of the venue",
1184
- "longitude": -122.418819,
1185
- "name": "Great American Music Hall",
1186
- "state": "CA",
1187
- "upcoming_events_count": 34,
1188
- "updated_at": "2011-01-20T21:04:37Z",
1189
- "postalcode": "94109",
1190
- "metro_area_id": 105,
1191
- "photos":
1192
- {
1193
- "thumbnail": "http://i.tc-core.com/venue/_default/default-thumbnail.jpg",
1194
- "medium": "http://i.tc-core.com/venue/_default/default-medium.jpg",
1195
- "large": "http://i.tc-core.com/venue/_default/default-large.jpg",
1196
- "mobile": "http://i.tc-core.com/venue/_default/default-mobile.jpg"
1197
- }
1198
- "url": "http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"
1270
+ "created_at": "2008-06-12T14:12:53Z",
1271
+ "id": 33642,
1272
+ "latitude": 39.765526,
1273
+ "long_description": null,
1274
+ "longitude": -84.203133,
1275
+ "name": "Dayton Masonic Center",
1276
+ "phone_number": null,
1277
+ "state": "OH",
1278
+ "time_zone": "America/New_York",
1279
+ "upcoming_events_count": 0,
1280
+ "updated_at": "2012-03-28T03:11:49Z",
1281
+ "postalcode": "45405",
1282
+ "photos": {
1283
+ "thumbnail": "http://i.development.tc-core.com/venue/_default/default-thumbnail.jpg",
1284
+ "medium": "http://i.development.tc-core.com/venue/_default/default-medium.jpg",
1285
+ "large": "http://i.development.tc-core.com/venue/_default/default-large.jpg",
1286
+ "mobile": "http://i.development.tc-core.com/venue/_default/default-mobile.jpg"
1287
+ },
1288
+ "metro_area_id": 134,
1289
+ "url": "http://thrillcall.com/venue/Dayton_Masonic_Center_in_Dayton_OH"
1199
1290
  },
1200
1291
  {
1201
1292
  ...
@@ -1226,20 +1317,24 @@ Params:
1226
1317
 
1227
1318
  - **[limit](#limit)**
1228
1319
  - **[page](#page)**
1320
+ - **[time\_zone](#time_zone)**
1229
1321
  - **[min\_date](#min_date)**
1230
1322
  - **[max\_date](#max_date)**
1323
+ - **[min\_updated\_at](#min_updated_at)**
1324
+ - **[max\_updated\_at](#max_updated_at)**
1231
1325
  - **[lat](#lat)**
1232
1326
  - **[long](#long)**
1233
1327
  - **[postalcode](#postalcode)**
1234
1328
  - **[radius](#radius)**
1235
1329
  - **[ticket\_type](#ticket_type)**
1330
+ - **[show\_disabled\_events](#show_disabled_events)**
1236
1331
  - **[show\_unconfirmed\_events](#show_unconfirmed_events)**
1237
1332
  - **[show\_rumor\_events](#show_rumor_events)**
1238
1333
 
1239
1334
  Returns: _Array_ of Tickets _Hash_
1240
1335
 
1241
1336
  ``` js
1242
- // Example: GET /api/v2/tickets?limit=14&api_key=1234567890abcdef
1337
+ // Example: GET /api/v3/tickets?limit=14&api_key=1234567890abcdef
1243
1338
 
1244
1339
  [
1245
1340
  {
@@ -1274,21 +1369,21 @@ Params:
1274
1369
  Returns: Ticket _Hash_
1275
1370
 
1276
1371
  ``` js
1277
- // Example: GET /api/v2/ticket/599794?api_key=1234567890abcdef
1372
+ // Example: GET /api/v3/ticket/819883?api_key=1234567890abcdef
1278
1373
 
1279
1374
  {
1280
- "created_at": "2011-06-14T00:09:16Z",
1375
+ "created_at": "2012-03-02T18:06:14Z",
1281
1376
  "description": null,
1282
- "event_id": 858707,
1283
- "id": 599794,
1377
+ "event_id": 1047075,
1378
+ "id": 819883,
1284
1379
  "marketing_text": null,
1285
- "max_ticket_price": 21,
1286
- "min_ticket_price": null,
1287
- "name": "Gen. Admission Seating Limited",
1380
+ "max_ticket_price": 85,
1381
+ "min_ticket_price": 29,
1382
+ "name": "Onsale to General Public",
1288
1383
  "on_sale_end_date": null,
1289
1384
  "on_sale_start_date": null,
1290
1385
  "seat_info": null,
1291
- "updated_at": "2011-06-14T00:09:16Z",
1292
- "url": "http://tickets.gamh.com/evinfo.php?eventid=154723&amp;r=affi&amp;u=210785"
1386
+ "updated_at": "2012-03-02T18:06:14Z",
1387
+ "url": "http://ticketsus.at/thrillcall?CTY=39&DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&brand=[=BRAND=]"
1293
1388
  }
1294
1389
  ```