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/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
  ```