thrillcall-api 0.0.4 → 0.0.6

Sign up to get free protection for your applications and to get access to all the features.
Files changed (12) hide show
  1. data/Gemfile.lock +18 -12
  2. data/README.md +429 -334
  3. data/docs/API.html +439 -336
  4. data/docs/API.md +426 -331
  5. data/docs/README.html +442 -339
  6. data/docs/WRAPPER.html +3 -3
  7. data/docs/WRAPPER.md +3 -3
  8. data/lib/thrillcall-api.rb +9 -3
  9. data/lib/thrillcall-api/version.rb +1 -1
  10. data/spec/thrillcall-api/thrillcall-api_spec.rb +116 -8
  11. data/thrillcall-api.gemspec +3 -1
  12. metadata +120 -28
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
  ```