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.
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/docs/API.md CHANGED
@@ -17,7 +17,7 @@ These are valid parameters for any endpoint, however, they will only be used by
17
17
 
18
18
  _Default: 100_
19
19
 
20
- Sets the maximum number of results to return. Cannot be above 100.
20
+ Sets the maximum number of results to return. Cannot be above 200.
21
21
 
22
22
  - <a name="page" />**page** _integer_
23
23
 
@@ -27,6 +27,13 @@ These are valid parameters for any endpoint, however, they will only be used by
27
27
 
28
28
  Specifies the page number. If limit is 10, then page = 2 will return results #20 through #29
29
29
 
30
+ - <a name="time_zone" />**time\_zone** _string (format: TZ Database string, eg "America/Los\_Angeles")_
31
+
32
+ _Default: UTC_
33
+ _For Metro Area endpoints, the default is instead the Metro Area's time zone and cannot be overridden._
34
+
35
+ **[min\_date](#min_date)** and **[max\_date](#max_date)** will be calculated based on this time zone.
36
+
30
37
  - <a name="min_date" />**min\_date** _string (format: "YYYY-MM-DD")_
31
38
 
32
39
  _Default: Today_
@@ -39,6 +46,18 @@ These are valid parameters for any endpoint, however, they will only be used by
39
46
 
40
47
  Results after this date will not be returned.
41
48
 
49
+ - <a name="min_updated_at" />**min\_updated\_at** _string (format: "YYYY-MM-DD")_
50
+
51
+ _Default: none_
52
+
53
+ Results with updated_at columns before this date will not be returned.
54
+
55
+ - <a name="max_date" />**max\_updated\_at** _string (format: "YYYY-MM-DD")_
56
+
57
+ _Default: none_
58
+
59
+ Results with updated_at columns after this date will not be returned.
60
+
42
61
  - <a name="lat" />**lat** _float_
43
62
 
44
63
  _Default: none_
@@ -88,6 +107,12 @@ These are valid parameters for any endpoint, however, they will only be used by
88
107
 
89
108
  If set to _true_ or _1_, will only return results that have tickets associated with them.
90
109
 
110
+ - <a name="show_disabled_events" />**show\_disabled\_events** _boolean_
111
+
112
+ _Default: false_
113
+
114
+ If set to _true_ or _1_, will not filter out events which have been disabled internally.
115
+
91
116
  - <a name="show_unconfirmed_events" />**show\_unconfirmed\_events** _boolean_
92
117
 
93
118
  _Default: false_
@@ -144,7 +169,7 @@ These are valid parameters for any endpoint, however, they will only be used by
144
169
 
145
170
  - <a name="referral_code" />**referral\_code** _string_
146
171
 
147
- 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.
172
+ 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.
148
173
 
149
174
 
150
175
  ## Artists
@@ -171,7 +196,7 @@ Params:
171
196
  Returns: _Array_ of Artists _Hash_
172
197
 
173
198
  ``` js
174
- // Example: GET /api/v2/artists?limit=14&api_key=1234567890abcdef
199
+ // Example: GET /api/v3/artists?limit=14&api_key=1234567890abcdef
175
200
 
176
201
  [
177
202
  {
@@ -182,13 +207,12 @@ Returns: _Array_ of Artists _Hash_
182
207
  "primary_genre_id": 61,
183
208
  "upcoming_events_count": 0,
184
209
  "updated_at": "2010-03-26T16:49:20Z",
185
- "photos":
186
- {
187
- "thumbnail": "http://i.tc-core.com/artist/_default/default-thumbnail.jpg",
188
- "medium": "http://i.tc-core.com/artist/_default/default-medium.jpg",
189
- "large": "http://i.tc-core.com/artist/_default/default-large.jpg",
190
- "mobile": "http://i.tc-core.com/artist/_default/default-mobile.jpg"
191
- },
210
+ "photos": {
211
+ "thumbnail": "http://i.development.tc-core.com/artist/_default/default-thumbnail.jpg",
212
+ "medium": "http://i.development.tc-core.com/artist/_default/default-medium.jpg",
213
+ "large": "http://i.development.tc-core.com/artist/_default/default-large.jpg",
214
+ "mobile": "http://i.development.tc-core.com/artist/_default/default-mobile.jpg"
215
+ },
192
216
  "url": "http://thrillcall.com/artist/Hyler_Jones_Proteges"
193
217
  },
194
218
  {
@@ -208,24 +232,23 @@ Params:
208
232
  Returns: Artist _Hash_
209
233
 
210
234
  ``` js
211
- // Example: GET /api/v2/artist/4802?api_key=1234567890abcdef
235
+ // Example: GET /api/v3/artist/378465?api_key=1234567890abcdef
212
236
 
213
237
  {
214
- "created_at": "2008-04-28T18:56:09Z",
215
- "genre_tags": "Rock",
216
- "id": 4802,
217
- "name": "The Sea and Cake",
218
- "primary_genre_id": 27,
219
- "upcoming_events_count": 8,
220
- "updated_at": "2011-09-20T19:12:57Z",
221
- "photos":
222
- {
223
- "thumbnail": "http://i.tc-core.com/artist/_default/default-thumbnail.jpg",
224
- "medium": "http://i.tc-core.com/artist/_default/default-medium.jpg",
225
- "large": "http://i.tc-core.com/artist/_default/default-large.jpg",
226
- "mobile": "http://i.tc-core.com/artist/_default/default-mobile.jpg"
227
- },
228
- "url": "http://thrillcall.com/artist/The_Sea_and_Cake"
238
+ "created_at": "2011-05-19T20:27:47Z",
239
+ "genre_tags": "Operatic pop",
240
+ "id": 378465,
241
+ "name": "Il Volo",
242
+ "primary_genre_id": 61,
243
+ "upcoming_events_count": 30,
244
+ "updated_at": "2012-03-27T15:59:04Z",
245
+ "photos": {
246
+ "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
247
+ "medium": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426",
248
+ "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
249
+ "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
250
+ },
251
+ "url": "http://thrillcall.com/artist/Il_Volo"
229
252
  }
230
253
  ```
231
254
 
@@ -236,8 +259,11 @@ Params:
236
259
 
237
260
  - **[limit](#limit)**
238
261
  - **[page](#page)**
262
+ - **[time\_zone](#time_zone)**
239
263
  - **[min\_date](#min_date)**
240
264
  - **[max\_date](#max_date)**
265
+ - **[min\_updated\_at](#min_updated_at)**
266
+ - **[max\_updated\_at](#max_updated_at)**
241
267
  - **[lat](#lat)**
242
268
  - **[long](#long)**
243
269
  - **[postalcode](#postalcode)**
@@ -245,40 +271,40 @@ Params:
245
271
  - **[use\_partner\_id](#use_partner_id)**
246
272
  - **[ticket\_type](#ticket_type)**
247
273
  - **[must\_have\_tickets](#must_have_tickets)**
274
+ - **[show\_disabled\_events](#show_disabled_events)**
248
275
  - **[show\_unconfirmed\_events](#show_unconfirmed_events)**
249
276
  - **[show\_rumor\_events](#show_rumor_events)**
250
277
 
251
278
  Returns: _Array_ of Events _Hash_
252
279
 
253
280
  ``` js
254
- // Example: GET /api/v2/artist/4802/events?api_key=1234567890abcdef
281
+ // Example: GET /api/v3/artist/378465/events?api_key=1234567890abcdef
255
282
 
256
283
  [
257
284
  {
258
- "created_at": "2011-06-23T23:10:31Z",
259
- "end_date": null,
285
+ "created_at": "2012-03-02T08:01:03Z",
260
286
  "festival": false,
261
- "id": 862618,
262
- "latitude": 30.2729,
263
- "longitude": -97.7405,
264
- "name": "The Sea and Cake @ The Mohawk",
265
- "num_cancelled_bookings": 0,
266
- "num_confirmed_bookings": 1,
267
- "num_disabled_bookings": 0,
268
- "num_unconfirmed_bookings": 0,
287
+ "id": 1046915,
288
+ "latitude": 47.6136,
289
+ "longitude": -122.332,
290
+ "name": "Il Volo @ Paramount Theatre - Seattle",
269
291
  "on_sale_date": null,
270
292
  "rumor": false,
271
- "start_date": "2011-12-09T05:59:00Z",
293
+ "start_date": "2012-10-02T19:30:00Z",
294
+ "starts_at": "2012-10-03T02:30:00Z",
295
+ "starts_at_time_trusted": true,
272
296
  "unconfirmed_location": 0,
273
- "updated_at": "2011-09-28T04:01:56Z",
274
- "venue_id": 10116,
275
- "photos":
276
- {
277
- "thumbnail": "http://i.tc-core.com/event/_default/default-thumbnail.jpg",
278
- "large": "http://i.tc-core.com/event/_default/default-large.jpg",
279
- "mobile": "http://i.tc-core.com/event/_default/default-mobile.jpg"
280
- },
281
- "url": "http://thrillcall.com/event/862618"
297
+ "updated_at": "2012-03-29T01:35:53Z",
298
+ "venue_id": 61705,
299
+ "photos": {
300
+ "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
301
+ "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
302
+ "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
303
+ },
304
+ "url": "http://thrillcall.com/event/1046915",
305
+ "starts_at_local": "2012-10-02T19:30:00-07:00",
306
+ "time_zone": "America/Los_Angeles",
307
+ "status": "confirmed"
282
308
  },
283
309
  {
284
310
  ...
@@ -298,25 +324,24 @@ Params:
298
324
  Returns: _Array_ of Artists _Hash_
299
325
 
300
326
  ``` js
301
- // Example: GET /api/v2/search/artists/The%20Sea%20and%20Cake?api_key=1234567890abcdef
327
+ // Example: GET /api/v3/search/artists/Il%20Volo?api_key=1234567890abcdef
302
328
 
303
329
  [
304
330
  {
305
- "created_at": "2008-04-28T18:56:09Z",
306
- "genre_tags": "Rock",
307
- "id": 4802,
308
- "name": "The Sea and Cake",
309
- "primary_genre_id": 27,
310
- "upcoming_events_count": 8,
311
- "updated_at": "2011-09-20T19:12:57Z",
312
- "photos":
313
- {
314
- "thumbnail": "http://i.tc-core.com/artist/_default/default-thumbnail.jpg",
315
- "medium": "http://i.tc-core.com/artist/_default/default-medium.jpg",
316
- "large": "http://i.tc-core.com/artist/_default/default-large.jpg",
317
- "mobile": "http://i.tc-core.com/artist/_default/default-mobile.jpg"
318
- },
319
- "url": "http://thrillcall.com/artist/The_Sea_and_Cake"
331
+ "created_at": "2011-05-19T20:27:47Z",
332
+ "genre_tags": "Operatic pop",
333
+ "id": 378465,
334
+ "name": "Il Volo",
335
+ "primary_genre_id": 61,
336
+ "upcoming_events_count": 30,
337
+ "updated_at": "2012-03-27T15:59:04Z",
338
+ "photos": {
339
+ "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
340
+ "medium": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426",
341
+ "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
342
+ "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
343
+ },
344
+ "url": "http://thrillcall.com/artist/Il_Volo"
320
345
  },
321
346
  {
322
347
  ...
@@ -329,20 +354,19 @@ Returns: _Array_ of Artists _Hash_
329
354
  Fields:
330
355
 
331
356
  - **created\_at** _string_ ISO 8601 representation the time this object was created
332
- - **end\_date** _string_ ISO 8601 representation of the end of the Event
333
357
  - **festival** _boolean_ Is this event a festival?
334
358
  - **id** _integer_ Thrillcall ID
335
359
  - **latitude** _float_ Approximate latitude for the Event
336
360
  - **longitude** _float_ Approximate longitude for the Event
337
361
  - **name** _string_ Name of the Event
338
- - **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.
339
- - **num\_unconfirmed\_bookings** _integer_ The number of unconfirmed Artist bookings for this event
340
- - **num\_disabled\_bookings** _integer_ The number of disabled Artist bookings for this event
341
- - **num\_cancelled\_bookings** _integer_ The number of cancelled Artist bookings for this event
342
362
  - **on\_sale\_date** _string_ ISO 8601 representation of the date when tickets go on sale
343
363
  - **rumor** _boolean_ Are the details for this event based on a rumor?
344
- - **start\_date** _string_ YYYY-MM-DD or, if time of day is known, ISO 8601 representation of the start of the Event
345
- - **unconfirmed\_location** _integer_ If 1, the location if this event is unconfirmed
364
+ - **status** _string_ Status of the event (confirmed, unconfirmed, cancelled, or disabled)
365
+ - **starts\_at** _string_ ISO 8601 representation of the start of the Event in UTC time
366
+ - **starts\_at\_local** _string_ ISO 8601 representation of the start of the Event in the local timezone
367
+ - **starts\_at\_time\_trusted** _boolean_ Do we trust that the time of day component of **starts\_at** is valid?
368
+ - **time\_zone** _string_ TZ Database string representing the time zone at the location of the event
369
+ - **unconfirmed\_location** _integer_ If 1, the location of this event is unconfirmed
346
370
  - **updated\_at** _string_ ISO 8601 representation of last time this object was updated
347
371
  - **venue\_id** _integer_ Thrillcall Venue ID
348
372
  - **photos** _hash_ A hash of image urls of the primary photo available for this object in different styles
@@ -354,48 +378,51 @@ Params:
354
378
 
355
379
  - **[limit](#limit)**
356
380
  - **[page](#page)**
381
+ - **[time\_zone](#time_zone)**
357
382
  - **[min\_date](#min_date)**
358
383
  - **[max\_date](#max_date)**
384
+ - **[min\_updated\_at](#min_updated_at)**
385
+ - **[max\_updated\_at](#max_updated_at)**
359
386
  - **[lat](#lat)**
360
387
  - **[long](#long)**
361
388
  - **[postalcode](#postalcode)**
362
389
  - **[radius](#radius)**
363
390
  - **[ticket\_type](#ticket_type)**
364
391
  - **[must\_have\_tickets](#must_have_tickets)**
392
+ - **[show\_disabled\_events](#show_disabled_events)**
365
393
  - **[show\_unconfirmed\_events](#show_unconfirmed_events)**
366
394
  - **[show\_rumor\_events](#show_rumor_events)**
367
395
 
368
396
  Returns: _Array_ of Events _Hash_
369
397
 
370
398
  ``` js
371
- // Example: GET /api/v2/events?must_have_tickets=true&postalcode=94108&radius=10&limit=3&api_key=1234567890abcdef
399
+ // Example: GET /api/v3/events?must_have_tickets=true&postalcode=94108&radius=10&limit=3&api_key=1234567890abcdef
372
400
 
373
401
  [
374
402
  {
375
- "created_at": "2011-06-14T00:09:13Z",
376
- "end_date": null,
403
+ "created_at": "2012-03-02T18:06:14Z",
377
404
  "festival": false,
378
- "id": 858707,
379
- "latitude": 37.7951,
380
- "longitude": -122.421,
381
- "name": "The Sea and Cake @ Great American Music Hall",
382
- "num_cancelled_bookings": 0,
383
- "num_confirmed_bookings": 1,
384
- "num_disabled_bookings": 0,
385
- "num_unconfirmed_bookings": 0,
405
+ "id": 1047075,
406
+ "latitude": 37.7915,
407
+ "longitude": -122.413,
408
+ "name": "Il Volo @ Masonic Center",
386
409
  "on_sale_date": null,
387
410
  "rumor": false,
388
- "start_date": "2011-12-06T07:59:00Z",
411
+ "start_date": "2012-09-29T19:30:04Z",
412
+ "starts_at": "2012-09-30T02:30:04Z",
413
+ "starts_at_time_trusted": true,
389
414
  "unconfirmed_location": 0,
390
- "updated_at": "2011-09-28T04:00:41Z",
391
- "venue_id": 27418,
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/858707"
415
+ "updated_at": "2012-03-29T01:35:57Z",
416
+ "venue_id": 63279,
417
+ "photos": {
418
+ "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
419
+ "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
420
+ "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
421
+ },
422
+ "url": "http://thrillcall.com/event/1047075",
423
+ "starts_at_local": "2012-09-29T19:30:04-07:00",
424
+ "time_zone": "America/Los_Angeles"
425
+ "status": "confirmed"
399
426
  },
400
427
  {
401
428
  ...
@@ -414,33 +441,33 @@ Params:
414
441
  Returns: Event _Hash_
415
442
 
416
443
  ``` js
417
- // Example: GET /api/v2/event/858707?api_key=1234567890abcdef
444
+ // Example: GET /api/v3/event/1045602/venue?api_key=1234567890abcdef
418
445
 
419
446
  {
420
- "created_at": "2011-06-14T00:09:13Z",
421
- "end_date": null,
422
- "festival": false,
423
- "id": 858707,
424
- "latitude": 37.7951,
425
- "longitude": -122.421,
426
- "name": "The Sea and Cake @ Great American Music Hall",
427
- "num_cancelled_bookings": 0,
428
- "num_confirmed_bookings": 1,
429
- "num_disabled_bookings": 0,
430
- "num_unconfirmed_bookings": 0,
431
- "on_sale_date": null,
432
- "rumor": false,
433
- "start_date": "2011-12-06T07:59:00Z",
434
- "unconfirmed_location": 0,
435
- "updated_at": "2011-09-28T04:00:41Z",
436
- "venue_id": 27418,
437
- "photos":
438
- {
439
- "thumbnail": "http://i.tc-core.com/event/_default/default-thumbnail.jpg",
440
- "large": "http://i.tc-core.com/event/_default/default-large.jpg",
441
- "mobile": "http://i.tc-core.com/event/_default/default-mobile.jpg"
442
- },
443
- "url": "http://thrillcall.com/event/858707"
447
+ "address1": "1111 California Street",
448
+ "address2": null,
449
+ "city": "San Francisco",
450
+ "country": "US",
451
+ "created_at": "2009-08-25T19:25:27Z",
452
+ "id": 63279,
453
+ "latitude": 37.79153,
454
+ "long_description": null,
455
+ "longitude": -122.412757,
456
+ "name": "Masonic Center",
457
+ "phone_number": null,
458
+ "state": "CA",
459
+ "time_zone": "America/Los_Angeles",
460
+ "upcoming_events_count": 4,
461
+ "updated_at": "2012-04-04T02:08:50Z",
462
+ "postalcode": "94108",
463
+ "photos": {
464
+ "thumbnail": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135",
465
+ "medium": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135",
466
+ "large": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135",
467
+ "mobile": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"
468
+ },
469
+ "metro_area_id": 105,
470
+ "url": "http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"
444
471
  }
445
472
  ```
446
473
 
@@ -455,25 +482,24 @@ Params:
455
482
  Returns: _Array_ of Artists _Hash_
456
483
 
457
484
  ``` js
458
- // Example: GET /api/v2/event/858707/artists?api_key=1234567890abcdef
485
+ // Example: GET /api/v3/event/1047075/artists?api_key=1234567890abcdef
459
486
 
460
487
  [
461
488
  {
462
- "created_at": "2008-04-28T18:56:09Z",
463
- "genre_tags": "Rock",
464
- "id": 4802,
465
- "name": "The Sea and Cake",
466
- "primary_genre_id": 27,
467
- "upcoming_events_count": 8,
468
- "updated_at": "2011-09-20T19:12:57Z",
469
- "photos":
470
- {
471
- "thumbnail": "http://i.tc-core.com/artist/_default/default-thumbnail.jpg",
472
- "medium": "http://i.tc-core.com/artist/_default/default-medium.jpg",
473
- "large": "http://i.tc-core.com/artist/_default/default-large.jpg",
474
- "mobile": "http://i.tc-core.com/artist/_default/default-mobile.jpg"
475
- },
476
- "url": "http://thrillcall.com/artist/The_Sea_and_Cake"
489
+ "created_at": "2011-05-19T20:27:47Z",
490
+ "genre_tags": "Operatic pop",
491
+ "id": 378465,
492
+ "name": "Il Volo",
493
+ "primary_genre_id": 61,
494
+ "upcoming_events_count": 30,
495
+ "updated_at": "2012-03-27T15:59:04Z",
496
+ "photos": {
497
+ "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
498
+ "medium": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426",
499
+ "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
500
+ "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
501
+ },
502
+ "url": "http://thrillcall.com/artist/Il_Volo"
477
503
  },
478
504
  {
479
505
  ...
@@ -492,31 +518,33 @@ Params:
492
518
  Returns: Venue _Hash_
493
519
 
494
520
  ``` js
495
- // Example: GET /api/v2/event/858707/venue?api_key=1234567890abcdef
521
+ // Example: GET /api/v3/event/1045602/venue?api_key=1234567890abcdef
496
522
 
497
523
  {
498
- "address1": "859 O'Farrell St.",
524
+ "address1": "1111 California Street",
499
525
  "address2": null,
500
526
  "city": "San Francisco",
501
527
  "country": "US",
502
- "created_at": "2008-04-21T16:52:31Z",
503
- "id": 27418,
504
- "latitude": 37.784796,
505
- "longitude": -122.418819,
506
- "name": "Great American Music Hall",
528
+ "created_at": "2009-08-25T19:25:27Z",
529
+ "id": 63279,
530
+ "latitude": 37.79153,
531
+ "long_description": null,
532
+ "longitude": -122.412757,
533
+ "name": "Masonic Center",
534
+ "phone_number": null,
507
535
  "state": "CA",
508
- "upcoming_events_count": 34,
509
- "updated_at": "2011-01-20T21:04:37Z",
510
- "postalcode": "94109",
536
+ "time_zone": "America/Los_Angeles",
537
+ "upcoming_events_count": 4,
538
+ "updated_at": "2012-04-04T02:08:50Z",
539
+ "postalcode": "94108",
540
+ "photos": {
541
+ "thumbnail": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135",
542
+ "medium": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135",
543
+ "large": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135",
544
+ "mobile": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"
545
+ },
511
546
  "metro_area_id": 105,
512
- "photos":
513
- {
514
- "thumbnail": "http://i.tc-core.com/venue/_default/default-thumbnail.jpg",
515
- "medium": "http://i.tc-core.com/venue/_default/default-medium.jpg",
516
- "large": "http://i.tc-core.com/venue/_default/default-large.jpg",
517
- "mobile": "http://i.tc-core.com/venue/_default/default-mobile.jpg"
518
- }
519
- "url": "http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"
547
+ "url": "http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"
520
548
  }
521
549
  ```
522
550
 
@@ -532,23 +560,23 @@ Params:
532
560
  Returns: _Array_ of Tickets _Hash_
533
561
 
534
562
  ``` js
535
- // Example: GET /api/v2/event/858707/tickets?api_key=1234567890abcdef
563
+ // Example: GET /api/v3/event/1047075/tickets?api_key=1234567890abcdef
536
564
 
537
565
  [
538
566
  {
539
- "created_at": "2011-06-14T00:09:16Z",
567
+ "created_at": "2012-03-02T18:06:14Z",
540
568
  "description": null,
541
- "event_id": 858707,
542
- "id": 599794,
569
+ "event_id": 1047075,
570
+ "id": 819883,
543
571
  "marketing_text": null,
544
- "max_ticket_price": 21,
545
- "min_ticket_price": null,
546
- "name": "Gen. Admission Seating Limited",
572
+ "max_ticket_price": 85,
573
+ "min_ticket_price": 29,
574
+ "name": "Onsale to General Public",
547
575
  "on_sale_end_date": null,
548
576
  "on_sale_start_date": null,
549
577
  "seat_info": null,
550
- "updated_at": "2011-06-14T00:09:16Z",
551
- "url": "http://tickets.gamh.com/evinfo.php?eventid=154723&amp;r=affi&amp;u=210785"
578
+ "updated_at": "2012-03-02T18:06:14Z",
579
+ "url": "http://ticketsus.at/thrillcall?CTY=39&DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&brand=[=BRAND=]"
552
580
  },
553
581
  {
554
582
  ...
@@ -575,7 +603,7 @@ Params:
575
603
  Returns: _Array_ of Genres _Hash_
576
604
 
577
605
  ``` js
578
- // Example: GET /api/v2/genres?limit=14&api_key=1234567890abcdef
606
+ // Example: GET /api/v3/genres?limit=14&api_key=1234567890abcdef
579
607
 
580
608
  [
581
609
  {
@@ -602,7 +630,7 @@ Params:
602
630
  Returns: Genre _Hash_
603
631
 
604
632
  ``` js
605
- // Example: GET /api/v2/genre/27?api_key=1234567890abcdef
633
+ // Example: GET /api/v3/genre/27?api_key=1234567890abcdef
606
634
 
607
635
  {
608
636
  "created_at": "2008-07-09T19:17:45Z",
@@ -624,25 +652,24 @@ Params:
624
652
  Returns: _Array_ of Artists _Hash_
625
653
 
626
654
  ``` js
627
- // Example: GET /api/v2/genre/27/artists?api_key=1234567890abcdef
655
+ // Example: GET /api/v3/genre/61/artists?api_key=1234567890abcdef
628
656
 
629
657
  [
630
658
  {
631
- "created_at": "2008-04-29T10:06:05Z",
632
- "genre_tags": "Folk;Other;psychedelic",
633
- "id": 2,
634
- "name": "Espers",
635
- "primary_genre_id": 27,
636
- "upcoming_events_count": 1,
637
- "updated_at": "2011-01-03T22:14:36Z",
638
- "photos":
639
- {
640
- "thumbnail": "http://i.tc-core.com/artist/_default/default-thumbnail.jpg",
641
- "medium": "http://i.tc-core.com/artist/_default/default-medium.jpg",
642
- "large": "http://i.tc-core.com/artist/_default/default-large.jpg",
643
- "mobile": "http://i.tc-core.com/artist/_default/default-mobile.jpg"
644
- },
645
- "url": "http://thrillcall.com/artist/Espers"
659
+ "created_at": "2008-04-29T10:19:45Z",
660
+ "genre_tags": "O",
661
+ "id": 1,
662
+ "name": "Hyler Jones Proteges",
663
+ "primary_genre_id": 61,
664
+ "upcoming_events_count": 0,
665
+ "updated_at": "2010-03-26T16:49:20Z",
666
+ "photos": {
667
+ "thumbnail": "http://i.development.tc-core.com/artist/_default/default-thumbnail.jpg",
668
+ "medium": "http://i.development.tc-core.com/artist/_default/default-medium.jpg",
669
+ "large": "http://i.development.tc-core.com/artist/_default/default-large.jpg",
670
+ "mobile": "http://i.development.tc-core.com/artist/_default/default-mobile.jpg"
671
+ },
672
+ "url": "http://thrillcall.com/artist/Hyler_Jones_Proteges"
646
673
  },
647
674
  {
648
675
  ...
@@ -654,17 +681,18 @@ Returns: _Array_ of Artists _Hash_
654
681
  ## Metro Area
655
682
  Fields:
656
683
 
657
- - **city** _string_ City of the Metro Area
658
- - **country** _string_ Country of the Metro Area
659
- - **created\_at** _string_ ISO 8601 representation the time this object was created
660
- - **id** _integer_ Thrillcall ID
661
- - **latitude** _float_ Latitude of the Metro Area
662
- - **longitude** _float_ Longitude of the Metro Area
663
- - **radius** _integer_ Radius of the Metro Area from the Lat/Long center
664
- - **state** _string_ State of the Metro Area
665
- - **time\_zone** _string_ Time zone of the Metro Area
666
- - **updated\_at** _string_ ISO 8601 representation of last time this object was updated
667
- - **url** _string_ URL for this object on Thrillcall
684
+ - **city** _string_ City of the Metro Area
685
+ - **country** _string_ Country of the Metro Area
686
+ - **created\_at** _string_ ISO 8601 representation the time this object was created
687
+ - **id** _integer_ Thrillcall ID
688
+ - **latitude** _float_ Latitude of the Metro Area
689
+ - **longitude** _float_ Longitude of the Metro Area
690
+ - **radius** _integer_ Radius of the Metro Area from the Lat/Long center
691
+ - **state** _string_ State of the Metro Area
692
+ - **time\_zone** _string_ Time zone of the Metro Area
693
+ - **updated\_at** _string_ ISO 8601 representation of last time this object was updated
694
+ - **url** _string_ URL for this object on Thrillcall
695
+ - **offers\_availability\_status\_code** _integer_ Offers status for the Metro Area ( no\_offers = 0, available = 1, coming\_soon = 2)
668
696
 
669
697
  ### GET /metro_areas
670
698
  Params:
@@ -675,7 +703,7 @@ Params:
675
703
  Returns: _Array_ of Metro Areas _Hash_
676
704
 
677
705
  ``` js
678
- // Example: GET /api/v2/metro_areas?limit=14&api_key=1234567890abcdef
706
+ // Example: GET /api/v3/metro_areas?limit=14&api_key=1234567890abcdef
679
707
 
680
708
  [
681
709
  {
@@ -685,10 +713,11 @@ Returns: _Array_ of Metro Areas _Hash_
685
713
  "id": 104,
686
714
  "latitude": 41.8842,
687
715
  "longitude": -87.6324,
716
+ "offers_availability_status_code": 1,
688
717
  "radius": 50,
689
718
  "state": "IL",
690
719
  "time_zone": "America/Chicago",
691
- "updated_at": "2011-07-05T23:11:24Z",
720
+ "updated_at": "2011-12-27T00:44:37Z",
692
721
  "url": "http://thrillcall.com/live-music/chicago"
693
722
  },
694
723
  {
@@ -708,7 +737,7 @@ Params:
708
737
  Returns: Metro Area _Hash_
709
738
 
710
739
  ``` js
711
- // Example: GET /api/v2/metro_area/105?api_key=1234567890abcdef
740
+ // Example: GET /api/v3/metro_area/105?api_key=1234567890abcdef
712
741
 
713
742
  {
714
743
  "city": "San Francisco",
@@ -717,10 +746,11 @@ Returns: Metro Area _Hash_
717
746
  "id": 105,
718
747
  "latitude": 37.7771,
719
748
  "longitude": -122.42,
749
+ "offers_availability_status_code": 1,
720
750
  "radius": 50,
721
751
  "state": "CA",
722
- "time_zone": "America/Chicago",
723
- "updated_at": "2011-07-05T23:11:24Z",
752
+ "time_zone": "America/Los_Angeles",
753
+ "updated_at": "2011-12-27T00:44:37Z",
724
754
  "url": "http://thrillcall.com/live-music/san-francisco"
725
755
  }
726
756
  ```
@@ -734,43 +764,47 @@ Params:
734
764
  - **[page](#page)**
735
765
  - **[min\_date](#min_date)**
736
766
  - **[max\_date](#max_date)**
767
+ - **[min\_updated\_at](#min_updated_at)**
768
+ - **[max\_updated\_at](#max_updated_at)**
737
769
  - **[radius](#radius)**
738
770
  - **[ticket\_type](#ticket_type)**
739
771
  - **[must\_have\_tickets](#must_have_tickets)**
772
+ - **[show\_disabled\_events](#show_disabled_events)**
740
773
  - **[show\_unconfirmed\_events](#show_unconfirmed_events)**
741
774
  - **[show\_rumor\_events](#show_rumor_events)**
742
775
 
776
+ Note: Time Zone is set as the time zone of the Metro Area and cannot be overridden.
777
+
743
778
  Returns: _Array_ of Metro Areas _Hash_
744
779
 
745
780
  ``` js
746
- // Example: GET /api/v2/metro_area/105/events?api_key=1234567890abcdef
781
+ // Example: GET /api/v3/metro_area/105/events?min_date=2011-04-05&max_date=2012-04-04&limit=3&api_key=1234567890abcdef
747
782
 
748
783
  [
749
784
  {
750
- "created_at": "2011-04-24T02:12:09Z",
751
- "end_date": null,
785
+ "created_at": "2012-01-02T08:53:00Z",
752
786
  "festival": false,
753
- "id": 831330,
754
- "latitude": 37.7794,
755
- "longitude": -122.418,
756
- "name": "Philadelphia Orchestra @ Davies Symphony Hall",
757
- "num_cancelled_bookings": 0,
758
- "num_confirmed_bookings": 1,
759
- "num_disabled_bookings": 0,
760
- "num_unconfirmed_bookings": 0,
787
+ "id": 1011386,
788
+ "latitude": 37.7771,
789
+ "longitude": -122.42,
790
+ "name": "Kontrol @ The End Up",
761
791
  "on_sale_date": null,
762
792
  "rumor": false,
763
- "start_date": "2012-06-11T06:59:00Z",
793
+ "start_date": "2012-01-07T00:00:04Z",
794
+ "starts_at": "2012-01-07T08:00:04Z",
795
+ "starts_at_time_trusted": false,
764
796
  "unconfirmed_location": 0,
765
- "updated_at": "2011-09-28T03:51:22Z",
766
- "venue_id": 51886,
767
- "photos":
768
- {
769
- "thumbnail": "http://i.tc-core.com/event/_default/default-thumbnail.jpg",
770
- "large": "http://i.tc-core.com/event/_default/default-large.jpg",
771
- "mobile": "http://i.tc-core.com/event/_default/default-mobile.jpg"
772
- },
773
- "url": "http://thrillcall.com/event/831330"
797
+ "updated_at": "2012-03-29T01:19:31Z",
798
+ "venue_id": 47273,
799
+ "photos": {
800
+ "thumbnail": "http://i.development.tc-core.com/event/_default/default-thumbnail.jpg",
801
+ "large": "http://i.development.tc-core.com/event/_default/default-large.jpg",
802
+ "mobile": "http://i.development.tc-core.com/dan/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-mobile.jpg?1326489566"
803
+ },
804
+ "url": "http://thrillcall.com/event/1011386",
805
+ "starts_at_local": "2012-01-07T00:00:04-08:00",
806
+ "time_zone": "America/Los_Angeles"
807
+ "status": "confirmed"
774
808
  },
775
809
  {
776
810
  ...
@@ -792,10 +826,46 @@ Fields:
792
826
  - **login** _string_ Login (Email Address) of the Person
793
827
  - **updated\_at** _string_ ISO 8601 representation of last time this object was updated
794
828
  - **referral\_code** _string_ Referral code of the Person
795
- - **referral\_code\_count** _integer_ Number of Referral code used for the Person
829
+ - **referral\_credits** _integer_ Number of Referral credits the Person has (including bonus points)
796
830
  - **postalcode** _string_ Postalcode of the Person
797
831
  - **photos** _hash_ A hash of image urls of the primary photo available for this object in different styles
798
832
 
833
+ ### GET /person/:id
834
+ Params:
835
+
836
+ - None.
837
+
838
+ Returns: Person _Hash_
839
+
840
+ ``` js
841
+ // Example: GET /api/v3/person/49?api_key=1234567890abcdef
842
+
843
+ {
844
+ "address1": null,
845
+ "address2": null,
846
+ "city": "Santa Rosa",
847
+ "country_code": "US",
848
+ "created_at": "2011-10-17T18:54:31Z",
849
+ "first_name": "John",
850
+ "gender": "m",
851
+ "id": 49,
852
+ "last_name": "Doe",
853
+ "login": "bogus@bogus.com",
854
+ "state": "CA",
855
+ "time_zone": "America/Los_Angeles",
856
+ "timezone": "-7",
857
+ "updated_at": "2012-03-28T16:07:16Z",
858
+ "referral_code": null,
859
+ "referral_credits": 0,
860
+ "postalcode": "95407",
861
+ "photos": {
862
+ "small_thumb": "http://i.development.tc-core.com/dan/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
863
+ "thumbnail": "http://i.development.tc-core.com/dan/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
864
+ "medium": "http://i.development.tc-core.com/dan/person/164761/1324568419/19154-medium.jpg?1324568419"
865
+ }
866
+ }
867
+ ```
868
+
799
869
  ### POST /person/signin
800
870
  Params:
801
871
 
@@ -818,25 +888,30 @@ May perform registration ("signup") automatically if using **[provider](#provide
818
888
  Returns: Person _Hash_
819
889
 
820
890
  ``` js
821
- // Example: POST /api/v2/person/signin
891
+ // 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
822
892
 
823
893
  {
824
- "created_at": "2000-11-09T19:09:23Z",
825
- "first_name": "John",
894
+ "address1": null,
895
+ "address2": null,
896
+ "city": null,
897
+ "country_code": null,
898
+ "created_at": null,
899
+ "first_name": "Mister",
826
900
  "gender": null,
827
- "id": 49,
828
- "last_name": "Doe",
829
- "login": "john@example.com",
830
- "updated_at": "2011-11-09T19:09:23Z",
831
- "referral_code": "fhskjfhk3j43h43hjkh",
832
- "referral_code_count": 0,
833
- "photos":
834
- {
835
- "small_thumb": "http://i.tc-core.com/person/_default/default-small_thumb.jpg",
836
- "thumbnail": "http://i.tc-core.com/person/_default/default-thumbnail.jpg",
837
- "medium": "http://i.tc-core.com/person/_default/default-medium.jpg"
838
- },
839
- "postalcode": "94104"
901
+ "last_name": "Bogus",
902
+ "login": null,
903
+ "state": null,
904
+ "time_zone": null,
905
+ "timezone": null,
906
+ "updated_at": null,
907
+ "referral_code": null,
908
+ "referral_credits": 0,
909
+ "postalcode": null,
910
+ "photos": {
911
+ "small_thumb": "http://i.development.tc-core.com/person/_default/default-small_thumb.jpg",
912
+ "thumbnail": "http://i.development.tc-core.com/person/_default/default-thumbnail.jpg",
913
+ "medium": "http://i.development.tc-core.com/person/_default/default-medium.jpg"
914
+ }
840
915
  }
841
916
  ```
842
917
 
@@ -854,26 +929,31 @@ Params:
854
929
  Returns: Person _Hash_
855
930
 
856
931
  ``` js
857
- // Example: POST /api/v2/person/signup
932
+ // Example: POST /api/v3/person/signup?first_name=Mister&email=bogus%40bogus.com&password=bogus&postalcode=94108&api_key=1234567890abcdef
858
933
 
859
934
  {
860
- "created_at": "2000-11-09T19:09:23Z",
861
- "first_name": "John",
862
- "gender": null,
863
- "id": 49,
864
- "last_name": "Doe",
865
- "login": "john@example.com",
866
- "updated_at": "2011-11-09T19:09:23Z",
867
- "referral_code": "fhskjfhk3j43h43hjkh",
868
- "referral_code_count": 0,
869
- "photos":
870
- {
871
- "small_thumb": "http://i.tc-core.com/person/_default/default-small_thumb.jpg",
872
- "thumbnail": "http://i.tc-core.com/person/_default/default-thumbnail.jpg",
873
- "medium": "http://i.tc-core.com/person/_default/default-medium.jpg"
874
- },
875
- "postalcode": "94104"
876
- }
935
+ "address1": null,
936
+ "address2": null,
937
+ "city": null,
938
+ "country_code": null,
939
+ "created_at": null,
940
+ "first_name": "Mister",
941
+ "gender": null,
942
+ "last_name": null,
943
+ "login": null,
944
+ "state": null,
945
+ "time_zone": null,
946
+ "timezone": null,
947
+ "updated_at": null,
948
+ "referral_code": null,
949
+ "referral_credits": 0,
950
+ "postalcode": null,
951
+ "photos": {
952
+ "small_thumb": "http://i.development.tc-core.com/person/_default/default-small_thumb.jpg",
953
+ "thumbnail": "http://i.development.tc-core.com/person/_default/default-thumbnail.jpg",
954
+ "medium": "http://i.development.tc-core.com/person/_default/default-medium.jpg"
955
+ }
956
+ }
877
957
  ```
878
958
 
879
959
 
@@ -895,6 +975,7 @@ Fields:
895
975
  - **upcoming\_events\_count** _integer_ Number of upcoming events associated with this object
896
976
  - **updated\_at** _string_ ISO 8601 representation of last time this object was updated
897
977
  - **postalcode** _string_ Postal code for the Venue
978
+ - **phone\_number** _string_ Phone number for the Venue (including country code)
898
979
  - **photos** _hash_ A hash of image urls of the primary photo available for this object in different styles
899
980
  - **url** _string_ URL for this object on Thrillcall
900
981
 
@@ -912,7 +993,7 @@ Params:
912
993
  Returns: _Array_ of Venues _Hash_
913
994
 
914
995
  ``` js
915
- // Example: GET /api/v2/venues?limit=14&api_key=1234567890abcdef
996
+ // Example: GET /api/v3/venues?limit=14&api_key=1234567890abcdef
916
997
 
917
998
  [
918
999
  {
@@ -920,23 +1001,25 @@ Returns: _Array_ of Venues _Hash_
920
1001
  "address2": null,
921
1002
  "city": "Guadalajara",
922
1003
  "country": "MX",
923
- "created_at": "2000-11-09T19:09:23Z",
1004
+ "created_at": "2008-05-09T09:29:23Z",
924
1005
  "id": 1,
925
- "latitude": null,
926
- "long_description": "Description of the venue",
927
- "longitude": null,
1006
+ "latitude": 20.666222,
1007
+ "long_description": null,
1008
+ "longitude": -103.352089,
928
1009
  "name": "Fbolko",
1010
+ "phone_number": null,
929
1011
  "state": "MX",
1012
+ "time_zone": "America/Mexico_City",
930
1013
  "upcoming_events_count": 0,
931
- "updated_at": "2010-03-28T17:24:20Z",
1014
+ "updated_at": "2012-03-29T00:04:23Z",
932
1015
  "postalcode": null,
933
- "photos":
934
- {
935
- "thumbnail": "http://i.tc-core.com/venue/_default/default-thumbnail.jpg",
936
- "medium": "http://i.tc-core.com/venue/_default/default-medium.jpg",
937
- "large": "http://i.tc-core.com/venue/_default/default-large.jpg",
938
- "mobile": "http://i.tc-core.com/venue/_default/default-mobile.jpg"
939
- }
1016
+ "photos": {
1017
+ "thumbnail": "http://i.development.tc-core.com/venue/_default/default-thumbnail.jpg",
1018
+ "medium": "http://i.development.tc-core.com/venue/_default/default-medium.jpg",
1019
+ "large": "http://i.development.tc-core.com/venue/_default/default-large.jpg",
1020
+ "mobile": "http://i.development.tc-core.com/venue/_default/default-mobile.jpg"
1021
+ },
1022
+ "metro_area_id": null,
940
1023
  "url": "http://thrillcall.com/venue/Fbolko_in_Guadalajara_MX"
941
1024
  },
942
1025
  {
@@ -957,32 +1040,33 @@ Params:
957
1040
  Returns: Venue _Hash_
958
1041
 
959
1042
  ``` js
960
- // Example: GET /api/v2/venue/27418?api_key=1234567890abcdef
1043
+ // Example: GET /api/v3/venue/51886?api_key=1234567890abcdef
961
1044
 
962
1045
  {
963
- "address1": "859 O'Farrell St.",
1046
+ "address1": "201 Van Ness Avenue",
964
1047
  "address2": null,
965
1048
  "city": "San Francisco",
966
1049
  "country": "US",
967
- "created_at": "2008-04-21T16:52:31Z",
968
- "id": 27418,
969
- "latitude": 37.784796,
970
- "long_description": "Description of the venue",
971
- "longitude": -122.418819,
972
- "name": "Great American Music Hall",
1050
+ "created_at": "2008-04-28T17:59:32Z",
1051
+ "id": 51886,
1052
+ "latitude": 37.777402,
1053
+ "long_description": null,
1054
+ "longitude": -122.419815,
1055
+ "name": "Davies Symphony Hall",
1056
+ "phone_number": "(415) 864-6000",
973
1057
  "state": "CA",
974
- "upcoming_events_count": 34,
975
- "updated_at": "2011-01-20T21:04:37Z",
976
- "postalcode": "94109",
1058
+ "time_zone": "America/Los_Angeles",
1059
+ "upcoming_events_count": 48,
1060
+ "updated_at": "2012-03-28T03:13:27Z",
1061
+ "postalcode": "94102",
1062
+ "photos": {
1063
+ "thumbnail": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-thumbnail.jpg?1326417154",
1064
+ "medium": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-medium.jpg?1326417154",
1065
+ "large": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-large.jpg?1326417154",
1066
+ "mobile": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-mobile.jpg?1326417154"
1067
+ },
977
1068
  "metro_area_id": 105,
978
- "photos":
979
- {
980
- "thumbnail": "http://i.tc-core.com/venue/_default/default-thumbnail.jpg",
981
- "medium": "http://i.tc-core.com/venue/_default/default-medium.jpg",
982
- "large": "http://i.tc-core.com/venue/_default/default-large.jpg",
983
- "mobile": "http://i.tc-core.com/venue/_default/default-mobile.jpg"
984
- }
985
- "url": "http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"
1069
+ "url": "http://thrillcall.com/venue/Davies_Symphony_Hall_in_San_Francisco_CA"
986
1070
  }
987
1071
  ```
988
1072
 
@@ -993,42 +1077,48 @@ Params:
993
1077
 
994
1078
  - **[limit](#limit)**
995
1079
  - **[page](#page)**
1080
+ - **[time\_zone](#time_zone)**
996
1081
  - **[min\_date](#min_date)**
997
1082
  - **[max\_date](#max_date)**
1083
+ - **[min\_updated\_at](#min_updated_at)**
1084
+ - **[max\_updated\_at](#max_updated_at)**
998
1085
  - **[use\_partner\_id](#use_partner_id)**
999
1086
  - **[ticket\_type](#ticket_type)**
1000
1087
  - **[must\_have\_tickets](#must_have_tickets)**
1088
+ - **[show\_disabled\_events](#show_disabled_events)**
1001
1089
  - **[show\_unconfirmed\_events](#show_unconfirmed_events)**
1002
1090
  - **[show\_rumor\_events](#show_rumor_events)**
1003
1091
 
1004
1092
  Returns: _Array_ of Events _Hash_
1005
1093
 
1006
1094
  ``` js
1007
- // Example: GET /api/v2/venue/32065/events?api_key=1234567890abcdef
1095
+ // Example: GET /api/v3/venue/63279/events?api_key=1234567890abcdef
1008
1096
 
1009
1097
  [
1010
1098
  {
1011
- "created_at": "2000-11-09T19:09:23Z",
1012
- "end_date": null,
1099
+ "created_at": "2012-03-02T18:06:14Z",
1013
1100
  "festival": false,
1014
- "id": 824614,
1015
- "latitude": 37.8016,
1016
- "long_description": "Description of the venue",
1017
- "longitude": -80.4462,
1018
- "name": "Colt Ford @ West Virginia State Fair",
1101
+ "id": 1047075,
1102
+ "latitude": 37.7915,
1103
+ "longitude": -122.413,
1104
+ "name": "Il Volo @ Masonic Center",
1019
1105
  "on_sale_date": null,
1020
1106
  "rumor": false,
1021
- "start_date": "2011-08-21T03:59:00Z",
1107
+ "start_date": "2012-09-29T19:30:04Z",
1108
+ "starts_at": "2012-09-30T02:30:04Z",
1109
+ "starts_at_time_trusted": true,
1022
1110
  "unconfirmed_location": 0,
1023
- "updated_at": "2011-06-24T05:10:05Z",
1024
- "venue_id": 32065,
1025
- "photos":
1026
- {
1027
- "thumbnail": "http://i.tc-core.com/event/_default/default-thumbnail.jpg",
1028
- "large": "http://i.tc-core.com/event/_default/default-large.jpg",
1029
- "mobile": "http://i.tc-core.com/event/_default/default-mobile.jpg"
1030
- },
1031
- "url": "http://thrillcall.com/event/824614"
1111
+ "updated_at": "2012-03-29T01:35:57Z",
1112
+ "venue_id": 63279,
1113
+ "photos": {
1114
+ "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
1115
+ "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
1116
+ "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
1117
+ },
1118
+ "url": "http://thrillcall.com/event/1047075",
1119
+ "starts_at_local": "2012-09-29T19:30:04-07:00",
1120
+ "time_zone": "America/Los_Angeles"
1121
+ "status": "confirmed"
1032
1122
  },
1033
1123
  {
1034
1124
  ...
@@ -1052,33 +1142,34 @@ Params:
1052
1142
  Returns: _Array_ of Venues _Hash_
1053
1143
 
1054
1144
  ``` js
1055
- // Example: GET /api/v2/search/venues/Great%20American%20Music%20Hall?api_key=1234567890abcdef
1145
+ // Example: GET /api/v3/search/venues/Masonic%20Center?api_key=1234567890abcdef
1056
1146
 
1057
1147
  [
1058
1148
  {
1059
- "address1": "859 O'Farrell St.",
1149
+ "address1": "525 W Riverview Ave",
1060
1150
  "address2": null,
1061
- "city": "San Francisco",
1151
+ "city": "Dayton",
1062
1152
  "country": "US",
1063
- "created_at": "2008-04-21T16:52:31Z",
1064
- "id": 27418,
1065
- "latitude": 37.784796,
1066
- "long_description": "Description of the venue",
1067
- "longitude": -122.418819,
1068
- "name": "Great American Music Hall",
1069
- "state": "CA",
1070
- "upcoming_events_count": 34,
1071
- "updated_at": "2011-01-20T21:04:37Z",
1072
- "postalcode": "94109",
1073
- "metro_area_id": 105,
1074
- "photos":
1075
- {
1076
- "thumbnail": "http://i.tc-core.com/venue/_default/default-thumbnail.jpg",
1077
- "medium": "http://i.tc-core.com/venue/_default/default-medium.jpg",
1078
- "large": "http://i.tc-core.com/venue/_default/default-large.jpg",
1079
- "mobile": "http://i.tc-core.com/venue/_default/default-mobile.jpg"
1080
- }
1081
- "url": "http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"
1153
+ "created_at": "2008-06-12T14:12:53Z",
1154
+ "id": 33642,
1155
+ "latitude": 39.765526,
1156
+ "long_description": null,
1157
+ "longitude": -84.203133,
1158
+ "name": "Dayton Masonic Center",
1159
+ "phone_number": null,
1160
+ "state": "OH",
1161
+ "time_zone": "America/New_York",
1162
+ "upcoming_events_count": 0,
1163
+ "updated_at": "2012-03-28T03:11:49Z",
1164
+ "postalcode": "45405",
1165
+ "photos": {
1166
+ "thumbnail": "http://i.development.tc-core.com/venue/_default/default-thumbnail.jpg",
1167
+ "medium": "http://i.development.tc-core.com/venue/_default/default-medium.jpg",
1168
+ "large": "http://i.development.tc-core.com/venue/_default/default-large.jpg",
1169
+ "mobile": "http://i.development.tc-core.com/venue/_default/default-mobile.jpg"
1170
+ },
1171
+ "metro_area_id": 134,
1172
+ "url": "http://thrillcall.com/venue/Dayton_Masonic_Center_in_Dayton_OH"
1082
1173
  },
1083
1174
  {
1084
1175
  ...
@@ -1109,20 +1200,24 @@ Params:
1109
1200
 
1110
1201
  - **[limit](#limit)**
1111
1202
  - **[page](#page)**
1203
+ - **[time\_zone](#time_zone)**
1112
1204
  - **[min\_date](#min_date)**
1113
1205
  - **[max\_date](#max_date)**
1206
+ - **[min\_updated\_at](#min_updated_at)**
1207
+ - **[max\_updated\_at](#max_updated_at)**
1114
1208
  - **[lat](#lat)**
1115
1209
  - **[long](#long)**
1116
1210
  - **[postalcode](#postalcode)**
1117
1211
  - **[radius](#radius)**
1118
1212
  - **[ticket\_type](#ticket_type)**
1213
+ - **[show\_disabled\_events](#show_disabled_events)**
1119
1214
  - **[show\_unconfirmed\_events](#show_unconfirmed_events)**
1120
1215
  - **[show\_rumor\_events](#show_rumor_events)**
1121
1216
 
1122
1217
  Returns: _Array_ of Tickets _Hash_
1123
1218
 
1124
1219
  ``` js
1125
- // Example: GET /api/v2/tickets?limit=14&api_key=1234567890abcdef
1220
+ // Example: GET /api/v3/tickets?limit=14&api_key=1234567890abcdef
1126
1221
 
1127
1222
  [
1128
1223
  {
@@ -1157,21 +1252,21 @@ Params:
1157
1252
  Returns: Ticket _Hash_
1158
1253
 
1159
1254
  ``` js
1160
- // Example: GET /api/v2/ticket/599794?api_key=1234567890abcdef
1255
+ // Example: GET /api/v3/ticket/819883?api_key=1234567890abcdef
1161
1256
 
1162
1257
  {
1163
- "created_at": "2011-06-14T00:09:16Z",
1258
+ "created_at": "2012-03-02T18:06:14Z",
1164
1259
  "description": null,
1165
- "event_id": 858707,
1166
- "id": 599794,
1260
+ "event_id": 1047075,
1261
+ "id": 819883,
1167
1262
  "marketing_text": null,
1168
- "max_ticket_price": 21,
1169
- "min_ticket_price": null,
1170
- "name": "Gen. Admission Seating Limited",
1263
+ "max_ticket_price": 85,
1264
+ "min_ticket_price": 29,
1265
+ "name": "Onsale to General Public",
1171
1266
  "on_sale_end_date": null,
1172
1267
  "on_sale_start_date": null,
1173
1268
  "seat_info": null,
1174
- "updated_at": "2011-06-14T00:09:16Z",
1175
- "url": "http://tickets.gamh.com/evinfo.php?eventid=154723&amp;r=affi&amp;u=210785"
1269
+ "updated_at": "2012-03-02T18:06:14Z",
1270
+ "url": "http://ticketsus.at/thrillcall?CTY=39&DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&brand=[=BRAND=]"
1176
1271
  }
1177
1272
  ```