thrillcall-api 0.0.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (23) hide show
  1. data/.autotest +10 -0
  2. data/.gitignore +10 -0
  3. data/.rspec +4 -0
  4. data/.rvmrc +2 -0
  5. data/Gemfile +4 -0
  6. data/Gemfile.lock +58 -0
  7. data/README.md +1141 -0
  8. data/Rakefile +2 -0
  9. data/autotest/discover.rb +1 -0
  10. data/docs/API.html +1262 -0
  11. data/docs/API.md +1024 -0
  12. data/docs/README.html +1382 -0
  13. data/docs/WRAPPER.html +182 -0
  14. data/docs/WRAPPER.md +115 -0
  15. data/lib/thrillcall-api.rb +76 -0
  16. data/lib/thrillcall-api/exceptions.rb +7 -0
  17. data/lib/thrillcall-api/result.rb +142 -0
  18. data/lib/thrillcall-api/version.rb +3 -0
  19. data/script/convert_readme.rb +119 -0
  20. data/spec/spec_helper.rb +11 -0
  21. data/spec/thrillcall-api/thrillcall-api_spec.rb +477 -0
  22. data/thrillcall-api.gemspec +34 -0
  23. metadata +201 -0
data/Rakefile ADDED
@@ -0,0 +1,2 @@
1
+ require 'bundler'
2
+ Bundler::GemHelper.install_tasks
data/autotest/discover.rb ADDED
@@ -0,0 +1 @@
1
+ Autotest.add_discovery { "rspec2" }
data/docs/API.html ADDED
@@ -0,0 +1,1262 @@
1
+
2
+ <style type="text/css">
3
+ .highlight .hll { background-color: #ffffcc }
4
+ .highlight { background: #dddddd; }
5
+ .highlight .c { color: #408080; font-style: italic } /* Comment */
6
+ .highlight .err { border: 1px solid #FF0000 } /* Error */
7
+ .highlight .k { color: #008000; font-weight: bold } /* Keyword */
8
+ .highlight .o { color: #666666 } /* Operator */
9
+ .highlight .cm { color: #408080; font-style: italic } /* Comment.Multiline */
10
+ .highlight .cp { color: #BC7A00 } /* Comment.Preproc */
11
+ .highlight .c1 { color: #408080; font-style: italic } /* Comment.Single */
12
+ .highlight .cs { color: #408080; font-style: italic } /* Comment.Special */
13
+ .highlight .gd { color: #A00000 } /* Generic.Deleted */
14
+ .highlight .ge { font-style: italic } /* Generic.Emph */
15
+ .highlight .gr { color: #FF0000 } /* Generic.Error */
16
+ .highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
17
+ .highlight .gi { color: #00A000 } /* Generic.Inserted */
18
+ .highlight .go { color: #808080 } /* Generic.Output */
19
+ .highlight .gp { color: #000080; font-weight: bold } /* Generic.Prompt */
20
+ .highlight .gs { font-weight: bold } /* Generic.Strong */
21
+ .highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */
22
+ .highlight .gt { color: #0040D0 } /* Generic.Traceback */
23
+ .highlight .kc { color: #008000; font-weight: bold } /* Keyword.Constant */
24
+ .highlight .kd { color: #008000; font-weight: bold } /* Keyword.Declaration */
25
+ .highlight .kn { color: #008000; font-weight: bold } /* Keyword.Namespace */
26
+ .highlight .kp { color: #008000 } /* Keyword.Pseudo */
27
+ .highlight .kr { color: #008000; font-weight: bold } /* Keyword.Reserved */
28
+ .highlight .kt { color: #B00040 } /* Keyword.Type */
29
+ .highlight .m { color: #666666 } /* Literal.Number */
30
+ .highlight .s { color: #BA2121 } /* Literal.String */
31
+ .highlight .na { color: #7D9029 } /* Name.Attribute */
32
+ .highlight .nb { color: #008000 } /* Name.Builtin */
33
+ .highlight .nc { color: #0000FF; font-weight: bold } /* Name.Class */
34
+ .highlight .no { color: #880000 } /* Name.Constant */
35
+ .highlight .nd { color: #AA22FF } /* Name.Decorator */
36
+ .highlight .ni { color: #999999; font-weight: bold } /* Name.Entity */
37
+ .highlight .ne { color: #D2413A; font-weight: bold } /* Name.Exception */
38
+ .highlight .nf { color: #0000FF } /* Name.Function */
39
+ .highlight .nl { color: #A0A000 } /* Name.Label */
40
+ .highlight .nn { color: #0000FF; font-weight: bold } /* Name.Namespace */
41
+ .highlight .nt { color: #008000; font-weight: bold } /* Name.Tag */
42
+ .highlight .nv { color: #19177C } /* Name.Variable */
43
+ .highlight .ow { color: #AA22FF; font-weight: bold } /* Operator.Word */
44
+ .highlight .w { color: #bbbbbb } /* Text.Whitespace */
45
+ .highlight .mf { color: #666666 } /* Literal.Number.Float */
46
+ .highlight .mh { color: #666666 } /* Literal.Number.Hex */
47
+ .highlight .mi { color: #666666 } /* Literal.Number.Integer */
48
+ .highlight .mo { color: #666666 } /* Literal.Number.Oct */
49
+ .highlight .sb { color: #BA2121 } /* Literal.String.Backtick */
50
+ .highlight .sc { color: #BA2121 } /* Literal.String.Char */
51
+ .highlight .sd { color: #BA2121; font-style: italic } /* Literal.String.Doc */
52
+ .highlight .s2 { color: #BA2121 } /* Literal.String.Double */
53
+ .highlight .se { color: #BB6622; font-weight: bold } /* Literal.String.Escape */
54
+ .highlight .sh { color: #BA2121 } /* Literal.String.Heredoc */
55
+ .highlight .si { color: #BB6688; font-weight: bold } /* Literal.String.Interpol */
56
+ .highlight .sx { color: #008000 } /* Literal.String.Other */
57
+ .highlight .sr { color: #BB6688 } /* Literal.String.Regex */
58
+ .highlight .s1 { color: #BA2121 } /* Literal.String.Single */
59
+ .highlight .ss { color: #19177C } /* Literal.String.Symbol */
60
+ .highlight .bp { color: #008000 } /* Name.Builtin.Pseudo */
61
+ .highlight .vc { color: #19177C } /* Name.Variable.Class */
62
+ .highlight .vg { color: #19177C } /* Name.Variable.Global */
63
+ .highlight .vi { color: #19177C } /* Name.Variable.Instance */
64
+ .highlight .il { color: #666666 } /* Literal.Number.Integer.Long */
65
+ </style><h1>HTTPS Endpoints</h1>
66
+
67
+ <h3>SSL/TLS Endpoints Required:</h3>
68
+
69
+ <p>All API access must use the secure HTTPS endpoint : https://api.thrillcall.com:443
70
+ Access over an insecure HTTP (port 80) endpoint is now deprecated and will be disabled.</p>
71
+
72
+ <h3>Parameters</h3>
73
+
74
+ <p>These are valid parameters for any endpoint, however, they will only be used by the server where applicable.</p>
75
+
76
+ <p><strong>api_key</strong> MUST BE SUPPLIED for every endpoint.</p>
77
+
78
+ <ul>
79
+ <li>
80
+ <p><a name="api_key"></a><strong>api_key</strong> <em>string: (format: length == 16)</em></p>
81
+
82
+ <p>Your API key. Required for access to any endpoint.</p>
83
+ </li>
84
+ <li>
85
+ <p><a name="limit"></a><strong>limit</strong> <em>integer</em></p>
86
+
87
+ <p><em>Default: 100</em></p>
88
+
89
+ <p>Sets the maximum number of results to return. Cannot be above 100.</p>
90
+ </li>
91
+ <li>
92
+ <p><a name="page"></a><strong>page</strong> <em>integer</em></p>
93
+
94
+ <p><em>Default: 0</em></p>
95
+
96
+ <p>Used in conjunction with <strong><a href="#limit">limit</a></strong>.</p>
97
+
98
+ <p>Specifies the page number. If limit is 10, then page = 2 will return results #20 through #29</p>
99
+ </li>
100
+ <li>
101
+ <p><a name="min_date"></a><strong>min_date</strong> <em>string (format: "YYYY-MM-DD")</em></p>
102
+
103
+ <p><em>Default: Today</em></p>
104
+
105
+ <p>Results before this date will not be returned.</p>
106
+ </li>
107
+ <li>
108
+ <p><a name="max_date"></a><strong>max_date</strong> <em>string (format: "YYYY-MM-DD")</em></p>
109
+
110
+ <p><em>Default: 1 year from Today</em></p>
111
+
112
+ <p>Results after this date will not be returned.</p>
113
+ </li>
114
+ <li>
115
+ <p><a name="lat"></a><strong>lat</strong> <em>float</em></p>
116
+
117
+ <p><em>Default: none</em></p>
118
+
119
+ <p>If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a href="#long">long</a></strong>) if both are specified, results will be within <strong><a href="#radius">radius</a></strong> of this location.</p>
120
+ </li>
121
+ <li>
122
+ <p><a name="long"></a><strong>long</strong> <em>float</em></p>
123
+
124
+ <p><em>Default: none</em></p>
125
+
126
+ <p>If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a href="#long">long</a></strong>) if both are specified, results will be within <strong><a href="#radius">radius</a></strong> of this location.</p>
127
+ </li>
128
+ <li>
129
+ <p><a name="postalcode"></a><strong>postalcode</strong> <em>string (format: length &gt;= 5)</em></p>
130
+
131
+ <p><em>Default: none</em></p>
132
+
133
+ <p>Results will be within the <strong><a href="#radius">radius</a></strong> of this postal code.
134
+ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a href="#long">long</a></strong>) if both are specified, this will be ignored.</p>
135
+ </li>
136
+ <li>
137
+ <p><a name="radius"></a><strong>radius</strong> <em>float</em></p>
138
+
139
+ <p><em>Default: 100.0</em></p>
140
+
141
+ <p>Used in conjunction with <strong><a href="#postalcode">postalcode</a></strong></p>
142
+ </li>
143
+ <li>
144
+ <p><a name="use_partner_id"></a><strong>use_partner_id</strong> <em>boolean</em></p>
145
+
146
+ <p><em>Default: false</em></p>
147
+
148
+ <p>If set to <em>true</em> or <em>1</em>, instead of using Thrillcall internal IDs, treat any IDs in a request as belonging to your partner definition.</p>
149
+
150
+ <p>Contact us to set up a list of definitions.</p>
151
+ </li>
152
+ <li>
153
+ <p><a name="ticket_type"></a><strong>ticket_type</strong> <em>string (format: "primary" or "resale")</em></p>
154
+
155
+ <p><em>Default: both</em></p>
156
+
157
+ <p>If specified, will only return tickets from Primary or Resale merchants.</p>
158
+ </li>
159
+ <li>
160
+ <p><a name="must_have_tickets"></a><strong>must_have_tickets</strong> <em>boolean</em></p>
161
+
162
+ <p><em>Default: false</em></p>
163
+
164
+ <p>If set to <em>true</em> or <em>1</em>, will only return results that have tickets associated with them.</p>
165
+ </li>
166
+ <li>
167
+ <p><a name="show_unconfirmed_events"></a><strong>show_unconfirmed_events</strong> <em>boolean</em></p>
168
+
169
+ <p><em>Default: false</em></p>
170
+
171
+ <p>If set to <em>true</em> or <em>1</em>, will not filter out events with unconfirmed locations.</p>
172
+ </li>
173
+ <li>
174
+ <p><a name="show_rumor_events"></a><strong>show_rumor_events</strong> <em>boolean</em></p>
175
+
176
+ <p><em>Default: false</em></p>
177
+
178
+ <p>If set to <em>true</em> or <em>1</em>, will not filter out events marked as rumored.</p>
179
+ </li>
180
+ <li>
181
+ <p><a name="primary_genre_id"></a><strong>primary_genre_id</strong> <em>integer</em></p>
182
+
183
+ <p><em>Default: none</em></p>
184
+
185
+ <p>If set, will filter Artist results to only those with the specified <strong><a href="#primary_genre_id">primary_genre_id</a></strong></p>
186
+ </li>
187
+ <li>
188
+ <p><a name="login"></a><strong>login</strong> <em>string</em></p>
189
+
190
+ <p>Required to authenticate/register a user.</p>
191
+ </li>
192
+ <li>
193
+ <p><a name="password"></a><strong>password</strong> <em>string (format: 40 &gt;= length &gt;= 5)</em></p>
194
+
195
+ <p>Required to authenticate/register a user.</p>
196
+ </li>
197
+ <li>
198
+ <p><a name="first_name"></a><strong>first_name</strong> <em>string (format: 50 &gt;= length &gt;= 2)</em></p>
199
+
200
+ <p>Required to register a user.</p>
201
+ </li>
202
+ <li>
203
+ <p><a name="last_name"></a><strong>last_name</strong> <em>string (format: 50 &gt;= length &gt;= 2)</em></p>
204
+
205
+ <p>Optional for registering a user.</p>
206
+ </li>
207
+ <li>
208
+ <p><a name="email"></a><strong>email</strong> <em>string</em></p>
209
+
210
+ <p>Required to register a user.</p>
211
+ </li>
212
+ <li>
213
+ <p><a name="gender"></a><strong>gender</strong> <em>string (format: length == 1)</em></p>
214
+
215
+ <p>Optional for registering a user.</p>
216
+ </li>
217
+ </ul><h2>Artists</h2>
218
+
219
+ <p>Fields:</p>
220
+
221
+ <ul>
222
+ <li>
223
+ <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
224
+ <li>
225
+ <strong>genre_tags</strong> <em>string</em> Semicolon separated list of Genre names</li>
226
+ <li>
227
+ <strong>id</strong> <em>integer</em> Thrillcall ID</li>
228
+ <li>
229
+ <strong>name</strong> <em>string</em> Artist / Band Name</li>
230
+ <li>
231
+ <strong>primary_genre_id</strong> <em>integer</em> The Thrillcall ID for this artist's primary Genre</li>
232
+ <li>
233
+ <strong>upcoming_events_count</strong> <em>integer</em> Number of upcoming events associated with this object</li>
234
+ <li>
235
+ <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
236
+ <li>
237
+ <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
238
+ </ul><h3>GET /artists</h3>
239
+
240
+ <p>Params:</p>
241
+
242
+ <ul>
243
+ <li><strong><a href="#limit">limit</a></strong></li>
244
+ <li><strong><a href="#page">page</a></strong></li>
245
+ <li><strong><a href="#primary_genre_id">primary_genre_id</a></strong></li>
246
+ </ul><p>Returns: <em>Array</em> of Artists <em>Hash</em></p>
247
+
248
+ <div class="highlight">
249
+ <pre> <span class="c1">// Example: GET /api/v2/artists?limit=14&amp;api_key=1234567890abcdef</span>
250
+
251
+ <span class="p">[</span>
252
+ <span class="p">{</span>
253
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-29T10:19:45Z"</span><span class="p">,</span>
254
+ <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"O"</span><span class="p">,</span>
255
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
256
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Hyler Jones Proteges"</span><span class="p">,</span>
257
+ <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">61</span><span class="p">,</span>
258
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
259
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-26T16:49:20Z"</span><span class="p">,</span>
260
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Hyler_Jones_Proteges"</span>
261
+ <span class="p">},</span>
262
+ <span class="p">{</span>
263
+ <span class="p">...</span>
264
+ <span class="p">},</span>
265
+ <span class="p">...</span>
266
+ <span class="p">]</span>
267
+ </pre>
268
+ </div>
269
+
270
+
271
+ <h3>GET /artist/:id</h3>
272
+
273
+ <p><strong>:id</strong> <em>integer</em> Thrillcall or Partner ID</p>
274
+
275
+ <p>Params:</p>
276
+
277
+ <ul>
278
+ <li><strong><a href="#use_partner_id">use_partner_id</a></strong></li>
279
+ </ul><p>Returns: Artist <em>Hash</em></p>
280
+
281
+ <div class="highlight">
282
+ <pre> <span class="c1">// Example: GET /api/v2/artist/4802?api_key=1234567890abcdef</span>
283
+
284
+ <span class="p">{</span>
285
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-28T18:56:09Z"</span><span class="p">,</span>
286
+ <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Rock"</span><span class="p">,</span>
287
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">4802</span><span class="p">,</span>
288
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"The Sea and Cake"</span><span class="p">,</span>
289
+ <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
290
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">8</span><span class="p">,</span>
291
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-20T19:12:57Z"</span><span class="p">,</span>
292
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/The_Sea_and_Cake"</span>
293
+ <span class="p">}</span>
294
+ </pre>
295
+ </div>
296
+
297
+
298
+ <h3>GET /artist/:id/events</h3>
299
+
300
+ <p><strong>:id</strong> <em>integer</em> Thrillcall or Partner ID</p>
301
+
302
+ <p>Params:</p>
303
+
304
+ <ul>
305
+ <li><strong><a href="#limit">limit</a></strong></li>
306
+ <li><strong><a href="#page">page</a></strong></li>
307
+ <li><strong><a href="#min_date">min_date</a></strong></li>
308
+ <li><strong><a href="#max_date">max_date</a></strong></li>
309
+ <li><strong><a href="#lat">lat</a></strong></li>
310
+ <li><strong><a href="#long">long</a></strong></li>
311
+ <li><strong><a href="#postalcode">postalcode</a></strong></li>
312
+ <li><strong><a href="#radius">radius</a></strong></li>
313
+ <li><strong><a href="#use_partner_id">use_partner_id</a></strong></li>
314
+ <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
315
+ <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
316
+ <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
317
+ <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
318
+ </ul><p>Returns: <em>Array</em> of Events <em>Hash</em></p>
319
+
320
+ <div class="highlight">
321
+ <pre> <span class="c1">// Example: GET /api/v2/artist/4802/events?api_key=1234567890abcdef</span>
322
+
323
+ <span class="p">[</span>
324
+ <span class="p">{</span>
325
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-23T23:10:31Z"</span><span class="p">,</span>
326
+ <span class="s2">"end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
327
+ <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
328
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">862618</span><span class="p">,</span>
329
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">30.2729</span><span class="p">,</span>
330
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">97.7405</span><span class="p">,</span>
331
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"The Sea and Cake @ The Mohawk"</span><span class="p">,</span>
332
+ <span class="s2">"num_cancelled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
333
+ <span class="s2">"num_confirmed_bookings"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
334
+ <span class="s2">"num_disabled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
335
+ <span class="s2">"num_unconfirmed_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
336
+ <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
337
+ <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
338
+ <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2011-12-09T05:59:00Z"</span><span class="p">,</span>
339
+ <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
340
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T04:01:56Z"</span><span class="p">,</span>
341
+ <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">10116</span><span class="p">,</span>
342
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/862618"</span>
343
+ <span class="p">},</span>
344
+ <span class="p">{</span>
345
+ <span class="p">...</span>
346
+ <span class="p">},</span>
347
+ <span class="p">...</span>
348
+ <span class="p">]</span>
349
+ </pre>
350
+ </div>
351
+
352
+
353
+ <h3>GET /search/artists/:term</h3>
354
+
355
+ <p><strong>:term</strong> <em>string</em> Arbitrary search string on the <strong>name</strong> field. (alphanumerics only, underscore matches underscore, use '+' for space)</p>
356
+
357
+ <p>Params:</p>
358
+
359
+ <ul>
360
+ <li><strong><a href="#limit">limit</a></strong></li>
361
+ <li><strong><a href="#page">page</a></strong></li>
362
+ </ul><p>Returns: <em>Array</em> of Artists <em>Hash</em></p>
363
+
364
+ <div class="highlight">
365
+ <pre> <span class="c1">// Example: GET /api/v2/search/artists/The%20Sea%20and%20Cake?api_key=1234567890abcdef</span>
366
+
367
+ <span class="p">[</span>
368
+ <span class="p">{</span>
369
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-28T18:56:09Z"</span><span class="p">,</span>
370
+ <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Rock"</span><span class="p">,</span>
371
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">4802</span><span class="p">,</span>
372
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"The Sea and Cake"</span><span class="p">,</span>
373
+ <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
374
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">8</span><span class="p">,</span>
375
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-20T19:12:57Z"</span><span class="p">,</span>
376
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/The_Sea_and_Cake"</span>
377
+ <span class="p">},</span>
378
+ <span class="p">{</span>
379
+ <span class="p">...</span>
380
+ <span class="p">},</span>
381
+ <span class="p">...</span>
382
+ <span class="p">]</span>
383
+ </pre>
384
+ </div>
385
+
386
+
387
+ <h2>Events</h2>
388
+
389
+ <p>Fields:</p>
390
+
391
+ <ul>
392
+ <li>
393
+ <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
394
+ <li>
395
+ <strong>end_date</strong> <em>string</em> ISO 8601 representation of the end of the Event</li>
396
+ <li>
397
+ <strong>festival</strong> <em>boolean</em> Is this event a festival?</li>
398
+ <li>
399
+ <strong>id</strong> <em>integer</em> Thrillcall ID</li>
400
+ <li>
401
+ <strong>latitude</strong> <em>float</em> Approximate latitude for the Event</li>
402
+ <li>
403
+ <strong>longitude</strong> <em>float</em> Approximate longitude for the Event</li>
404
+ <li>
405
+ <strong>name</strong> <em>string</em> Name of the Event</li>
406
+ <li>
407
+ <strong>num_confirmed_bookings</strong> <em>integer</em> The number of confirmed Artist bookings for this event. Only Artists with a confirmed booking are returned when requesting artists for an event.</li>
408
+ <li>
409
+ <strong>num_unconfirmed_bookings</strong> <em>integer</em> The number of unconfirmed Artist bookings for this event</li>
410
+ <li>
411
+ <strong>num_disabled_bookings</strong> <em>integer</em> The number of disabled Artist bookings for this event</li>
412
+ <li>
413
+ <strong>num_cancelled_bookings</strong> <em>integer</em> The number of cancelled Artist bookings for this event</li>
414
+ <li>
415
+ <strong>on_sale_date</strong> <em>string</em> ISO 8601 representation of the date when tickets go on sale</li>
416
+ <li>
417
+ <strong>rumor</strong> <em>boolean</em> Are the details for this event based on a rumor?</li>
418
+ <li>
419
+ <strong>start_date</strong> <em>string</em> YYYY-MM-DD or, if time of day is known, ISO 8601 representation of the start of the Event</li>
420
+ <li>
421
+ <strong>unconfirmed_location</strong> <em>integer</em> If 1, the location if this event is unconfirmed</li>
422
+ <li>
423
+ <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
424
+ <li>
425
+ <strong>venue_id</strong> <em>integer</em> Thrillcall Venue ID</li>
426
+ <li>
427
+ <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
428
+ </ul><h3>GET /events</h3>
429
+
430
+ <p>Params:</p>
431
+
432
+ <ul>
433
+ <li><strong><a href="#limit">limit</a></strong></li>
434
+ <li><strong><a href="#page">page</a></strong></li>
435
+ <li><strong><a href="#min_date">min_date</a></strong></li>
436
+ <li><strong><a href="#max_date">max_date</a></strong></li>
437
+ <li><strong><a href="#lat">lat</a></strong></li>
438
+ <li><strong><a href="#long">long</a></strong></li>
439
+ <li><strong><a href="#postalcode">postalcode</a></strong></li>
440
+ <li><strong><a href="#radius">radius</a></strong></li>
441
+ <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
442
+ <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
443
+ <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
444
+ <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
445
+ </ul><p>Returns: <em>Array</em> of Events <em>Hash</em></p>
446
+
447
+ <div class="highlight">
448
+ <pre> <span class="c1">// Example: GET /api/v2/events?must_have_tickets=true&amp;postalcode=94108&amp;radius=10&amp;limit=3&amp;api_key=1234567890abcdef</span>
449
+
450
+ <span class="p">[</span>
451
+ <span class="p">{</span>
452
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:13Z"</span><span class="p">,</span>
453
+ <span class="s2">"end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
454
+ <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
455
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">858707</span><span class="p">,</span>
456
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7951</span><span class="p">,</span>
457
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.421</span><span class="p">,</span>
458
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"The Sea and Cake @ Great American Music Hall"</span><span class="p">,</span>
459
+ <span class="s2">"num_cancelled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
460
+ <span class="s2">"num_confirmed_bookings"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
461
+ <span class="s2">"num_disabled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
462
+ <span class="s2">"num_unconfirmed_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
463
+ <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
464
+ <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
465
+ <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2011-12-06T07:59:00Z"</span><span class="p">,</span>
466
+ <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
467
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T04:00:41Z"</span><span class="p">,</span>
468
+ <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
469
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/858707"</span>
470
+ <span class="p">},</span>
471
+ <span class="p">{</span>
472
+ <span class="p">...</span>
473
+ <span class="p">},</span>
474
+ <span class="p">...</span>
475
+ <span class="p">]</span>
476
+ </pre>
477
+ </div>
478
+
479
+
480
+ <h3>GET /event/:id</h3>
481
+
482
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
483
+
484
+ <p>Params:</p>
485
+
486
+ <ul>
487
+ <li>None</li>
488
+ </ul><p>Returns: Event <em>Hash</em></p>
489
+
490
+ <div class="highlight">
491
+ <pre> <span class="c1">// Example: GET /api/v2/event/858707?api_key=1234567890abcdef</span>
492
+
493
+ <span class="p">{</span>
494
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:13Z"</span><span class="p">,</span>
495
+ <span class="s2">"end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
496
+ <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
497
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">858707</span><span class="p">,</span>
498
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7951</span><span class="p">,</span>
499
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.421</span><span class="p">,</span>
500
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"The Sea and Cake @ Great American Music Hall"</span><span class="p">,</span>
501
+ <span class="s2">"num_cancelled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
502
+ <span class="s2">"num_confirmed_bookings"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
503
+ <span class="s2">"num_disabled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
504
+ <span class="s2">"num_unconfirmed_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
505
+ <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
506
+ <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
507
+ <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2011-12-06T07:59:00Z"</span><span class="p">,</span>
508
+ <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
509
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T04:00:41Z"</span><span class="p">,</span>
510
+ <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
511
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/858707"</span>
512
+ <span class="p">}</span>
513
+ </pre>
514
+ </div>
515
+
516
+
517
+ <h3>GET /event/:id/artists</h3>
518
+
519
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
520
+
521
+ <p>Params:</p>
522
+
523
+ <ul>
524
+ <li><strong><a href="#limit">limit</a></strong></li>
525
+ <li><strong><a href="#page">page</a></strong></li>
526
+ </ul><p>Returns: <em>Array</em> of Artists <em>Hash</em></p>
527
+
528
+ <div class="highlight">
529
+ <pre> <span class="c1">// Example: GET /api/v2/event/858707/artists?api_key=1234567890abcdef</span>
530
+
531
+ <span class="p">[</span>
532
+ <span class="p">{</span>
533
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-28T18:56:09Z"</span><span class="p">,</span>
534
+ <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Rock"</span><span class="p">,</span>
535
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">4802</span><span class="p">,</span>
536
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"The Sea and Cake"</span><span class="p">,</span>
537
+ <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
538
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">8</span><span class="p">,</span>
539
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-20T19:12:57Z"</span><span class="p">,</span>
540
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/The_Sea_and_Cake"</span>
541
+ <span class="p">},</span>
542
+ <span class="p">{</span>
543
+ <span class="p">...</span>
544
+ <span class="p">},</span>
545
+ <span class="p">...</span>
546
+ <span class="p">]</span>
547
+ </pre>
548
+ </div>
549
+
550
+
551
+ <h3>GET /event/:id/venue</h3>
552
+
553
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
554
+
555
+ <p>Params:</p>
556
+
557
+ <ul>
558
+ <li>None</li>
559
+ </ul><p>Returns: Venue <em>Hash</em></p>
560
+
561
+ <div class="highlight">
562
+ <pre> <span class="c1">// Example: GET /api/v2/event/858707/venue?api_key=1234567890abcdef</span>
563
+
564
+ <span class="p">{</span>
565
+ <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"859 O'Farrell St."</span><span class="p">,</span>
566
+ <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
567
+ <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
568
+ <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
569
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-21T16:52:31Z"</span><span class="p">,</span>
570
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
571
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.784796</span><span class="p">,</span>
572
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.418819</span><span class="p">,</span>
573
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Great American Music Hall"</span><span class="p">,</span>
574
+ <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
575
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">34</span><span class="p">,</span>
576
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-20T21:04:37Z"</span><span class="p">,</span>
577
+ <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94109"</span><span class="p">,</span>
578
+ <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
579
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"</span>
580
+ <span class="p">}</span>
581
+ </pre>
582
+ </div>
583
+
584
+
585
+ <h3>GET /event/:id/tickets</h3>
586
+
587
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
588
+
589
+ <p>Params:</p>
590
+
591
+ <ul>
592
+ <li><strong><a href="#limit">limit</a></strong></li>
593
+ <li><strong><a href="#page">page</a></strong></li>
594
+ <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
595
+ </ul><p>Returns: <em>Array</em> of Tickets <em>Hash</em></p>
596
+
597
+ <div class="highlight">
598
+ <pre> <span class="c1">// Example: GET /api/v2/event/858707/tickets?api_key=1234567890abcdef</span>
599
+
600
+ <span class="p">[</span>
601
+ <span class="p">{</span>
602
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:16Z"</span><span class="p">,</span>
603
+ <span class="s2">"description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
604
+ <span class="s2">"event_id"</span><span class="o">:</span> <span class="mi">858707</span><span class="p">,</span>
605
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">599794</span><span class="p">,</span>
606
+ <span class="s2">"marketing_text"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
607
+ <span class="s2">"max_ticket_price"</span><span class="o">:</span> <span class="mi">21</span><span class="p">,</span>
608
+ <span class="s2">"min_ticket_price"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
609
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Gen. Admission Seating Limited"</span><span class="p">,</span>
610
+ <span class="s2">"on_sale_end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
611
+ <span class="s2">"on_sale_start_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
612
+ <span class="s2">"seat_info"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
613
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:16Z"</span><span class="p">,</span>
614
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://tickets.gamh.com/evinfo.php?eventid=154723&amp;amp;r=affi&amp;amp;u=210785"</span>
615
+ <span class="p">},</span>
616
+ <span class="p">{</span>
617
+ <span class="p">...</span>
618
+ <span class="p">},</span>
619
+ <span class="p">...</span>
620
+ <span class="p">]</span>
621
+ </pre>
622
+ </div>
623
+
624
+
625
+ <h2>Genre</h2>
626
+
627
+ <p>Fields:</p>
628
+
629
+ <ul>
630
+ <li>
631
+ <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
632
+ <li>
633
+ <strong>description</strong> <em>string</em> Description of the Genre</li>
634
+ <li>
635
+ <strong>id</strong> <em>integer</em> Thrillcall ID</li>
636
+ <li>
637
+ <strong>name</strong> <em>string</em> Name of the Genre</li>
638
+ <li>
639
+ <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
640
+ </ul><h3>GET /genres</h3>
641
+
642
+ <p>Params:</p>
643
+
644
+ <ul>
645
+ <li><strong><a href="#limit">limit</a></strong></li>
646
+ <li><strong><a href="#page">page</a></strong></li>
647
+ </ul><p>Returns: <em>Array</em> of Genres <em>Hash</em></p>
648
+
649
+ <div class="highlight">
650
+ <pre> <span class="c1">// Example: GET /api/v2/genres?limit=14&amp;api_key=1234567890abcdef</span>
651
+
652
+ <span class="p">[</span>
653
+ <span class="p">{</span>
654
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-07-09T19:17:45Z"</span><span class="p">,</span>
655
+ <span class="s2">"description"</span><span class="o">:</span> <span class="s2">"Shawn Colvin, Loudon Wainwright III etc..."</span><span class="p">,</span>
656
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">6</span><span class="p">,</span>
657
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Folk"</span><span class="p">,</span>
658
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-25T23:51:55Z"</span>
659
+ <span class="p">},</span>
660
+ <span class="p">{</span>
661
+ <span class="p">...</span>
662
+ <span class="p">},</span>
663
+ <span class="p">...</span>
664
+ <span class="p">]</span>
665
+ </pre>
666
+ </div>
667
+
668
+
669
+ <h3>GET /genre/:id</h3>
670
+
671
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
672
+
673
+ <p>Params:</p>
674
+
675
+ <ul>
676
+ <li>None</li>
677
+ </ul><p>Returns: Genre <em>Hash</em></p>
678
+
679
+ <div class="highlight">
680
+ <pre> <span class="c1">// Example: GET /api/v2/genre/27?api_key=1234567890abcdef</span>
681
+
682
+ <span class="p">{</span>
683
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-07-09T19:17:45Z"</span><span class="p">,</span>
684
+ <span class="s2">"description"</span><span class="o">:</span> <span class="s2">"U2, 30 Seconds To Mars etc..."</span><span class="p">,</span>
685
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
686
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Rock"</span><span class="p">,</span>
687
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-25T23:52:21Z"</span>
688
+ <span class="p">}</span>
689
+ </pre>
690
+ </div>
691
+
692
+
693
+ <h3>GET /genre/:id/artists</h3>
694
+
695
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
696
+
697
+ <p>Params:</p>
698
+
699
+ <ul>
700
+ <li><strong><a href="#limit">limit</a></strong></li>
701
+ <li><strong><a href="#page">page</a></strong></li>
702
+ </ul><p>Returns: <em>Array</em> of Artists <em>Hash</em></p>
703
+
704
+ <div class="highlight">
705
+ <pre> <span class="c1">// Example: GET /api/v2/genre/27/artists?api_key=1234567890abcdef</span>
706
+
707
+ <span class="p">[</span>
708
+ <span class="p">{</span>
709
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-29T10:06:05Z"</span><span class="p">,</span>
710
+ <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Folk;Other;psychedelic"</span><span class="p">,</span>
711
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">2</span><span class="p">,</span>
712
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Espers"</span><span class="p">,</span>
713
+ <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
714
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
715
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-03T22:14:36Z"</span><span class="p">,</span>
716
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Espers"</span>
717
+ <span class="p">},</span>
718
+ <span class="p">{</span>
719
+ <span class="p">...</span>
720
+ <span class="p">},</span>
721
+ <span class="p">...</span>
722
+ <span class="p">]</span>
723
+ </pre>
724
+ </div>
725
+
726
+
727
+ <h2>Metro Area</h2>
728
+
729
+ <p>Fields:</p>
730
+
731
+ <ul>
732
+ <li>
733
+ <strong>city</strong> <em>string</em> City of the Metro Area</li>
734
+ <li>
735
+ <strong>country</strong> <em>string</em> Country of the Metro Area</li>
736
+ <li>
737
+ <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
738
+ <li>
739
+ <strong>id</strong> <em>integer</em> Thrillcall ID</li>
740
+ <li>
741
+ <strong>latitude</strong> <em>float</em> Latitude of the Metro Area</li>
742
+ <li>
743
+ <strong>longitude</strong> <em>float</em> Longitude of the Metro Area</li>
744
+ <li>
745
+ <strong>radius</strong> <em>integer</em> Radius of the Metro Area from the Lat/Long center</li>
746
+ <li>
747
+ <strong>state</strong> <em>string</em> State of the Metro Area</li>
748
+ <li>
749
+ <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
750
+ <li>
751
+ <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
752
+ </ul><h3>GET /metro_areas</h3>
753
+
754
+ <p>Params:</p>
755
+
756
+ <ul>
757
+ <li><strong><a href="#limit">limit</a></strong></li>
758
+ <li><strong><a href="#page">page</a></strong></li>
759
+ </ul><p>Returns: <em>Array</em> of Metro Areas <em>Hash</em></p>
760
+
761
+ <div class="highlight">
762
+ <pre> <span class="c1">// Example: GET /api/v2/metro_areas?limit=14&amp;api_key=1234567890abcdef</span>
763
+
764
+ <span class="p">[</span>
765
+ <span class="p">{</span>
766
+ <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"Chicago"</span><span class="p">,</span>
767
+ <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
768
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-24T03:23:57Z"</span><span class="p">,</span>
769
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">104</span><span class="p">,</span>
770
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">41.8842</span><span class="p">,</span>
771
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">87.6324</span><span class="p">,</span>
772
+ <span class="s2">"radius"</span><span class="o">:</span> <span class="mi">50</span><span class="p">,</span>
773
+ <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"IL"</span><span class="p">,</span>
774
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-07-05T23:11:24Z"</span><span class="p">,</span>
775
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/live-music/chicago"</span>
776
+ <span class="p">},</span>
777
+ <span class="p">{</span>
778
+ <span class="p">...</span>
779
+ <span class="p">},</span>
780
+ <span class="p">...</span>
781
+ <span class="p">]</span>
782
+ </pre>
783
+ </div>
784
+
785
+
786
+ <h3>GET /metro_area/:id</h3>
787
+
788
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
789
+
790
+ <p>Params:</p>
791
+
792
+ <ul>
793
+ <li>None</li>
794
+ </ul><p>Returns: Metro Area <em>Hash</em></p>
795
+
796
+ <div class="highlight">
797
+ <pre> <span class="c1">// Example: GET /api/v2/metro_area/105?api_key=1234567890abcdef</span>
798
+
799
+ <span class="p">{</span>
800
+ <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
801
+ <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
802
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-24T03:23:57Z"</span><span class="p">,</span>
803
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
804
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7771</span><span class="p">,</span>
805
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.42</span><span class="p">,</span>
806
+ <span class="s2">"radius"</span><span class="o">:</span> <span class="mi">50</span><span class="p">,</span>
807
+ <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
808
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-07-05T23:11:24Z"</span><span class="p">,</span>
809
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/live-music/san-francisco"</span>
810
+ <span class="p">}</span>
811
+ </pre>
812
+ </div>
813
+
814
+
815
+ <h3>GET /metro_area/:id/events</h3>
816
+
817
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
818
+
819
+ <p>Params:</p>
820
+
821
+ <ul>
822
+ <li><strong><a href="#limit">limit</a></strong></li>
823
+ <li><strong><a href="#page">page</a></strong></li>
824
+ <li><strong><a href="#min_date">min_date</a></strong></li>
825
+ <li><strong><a href="#max_date">max_date</a></strong></li>
826
+ <li><strong><a href="#radius">radius</a></strong></li>
827
+ <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
828
+ <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
829
+ <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
830
+ <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
831
+ </ul><p>Returns: <em>Array</em> of Metro Areas <em>Hash</em></p>
832
+
833
+ <div class="highlight">
834
+ <pre> <span class="c1">// Example: GET /api/v2/metro_area/105/events?api_key=1234567890abcdef</span>
835
+
836
+ <span class="p">[</span>
837
+ <span class="p">{</span>
838
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-04-24T02:12:09Z"</span><span class="p">,</span>
839
+ <span class="s2">"end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
840
+ <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
841
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">831330</span><span class="p">,</span>
842
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7794</span><span class="p">,</span>
843
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.418</span><span class="p">,</span>
844
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Philadelphia Orchestra @ Davies Symphony Hall"</span><span class="p">,</span>
845
+ <span class="s2">"num_cancelled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
846
+ <span class="s2">"num_confirmed_bookings"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
847
+ <span class="s2">"num_disabled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
848
+ <span class="s2">"num_unconfirmed_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
849
+ <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
850
+ <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
851
+ <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2012-06-11T06:59:00Z"</span><span class="p">,</span>
852
+ <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
853
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T03:51:22Z"</span><span class="p">,</span>
854
+ <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">51886</span><span class="p">,</span>
855
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/831330"</span>
856
+ <span class="p">},</span>
857
+ <span class="p">{</span>
858
+ <span class="p">...</span>
859
+ <span class="p">},</span>
860
+ <span class="p">...</span>
861
+ <span class="p">]</span>
862
+ </pre>
863
+ </div>
864
+
865
+
866
+ <h2>Person</h2>
867
+
868
+ <p>Fields:</p>
869
+
870
+ <ul>
871
+ <li>
872
+ <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
873
+ <li>
874
+ <strong>first_name</strong> <em>string</em> First name of the Person</li>
875
+ <li>
876
+ <strong>gender</strong> <em>string</em> Gender of the Person</li>
877
+ <li>
878
+ <strong>id</strong> <em>integer</em> Thrillcall ID</li>
879
+ <li>
880
+ <strong>last_name</strong> <em>string</em> Last name of the Person</li>
881
+ <li>
882
+ <strong>login</strong> <em>string</em> Login of the Person</li>
883
+ <li>
884
+ <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
885
+ <li>
886
+ <strong>referral_code</strong> <em>string</em> Referral code of the Person</li>
887
+ <li>
888
+ <strong>referral_code_count</strong> <em>integer</em> Number of Referral code used for the Person</li>
889
+ <li>
890
+ <strong>postalcode</strong> <em>string</em> Postalcode of the Person</li>
891
+ <li>
892
+ <strong>postalcode</strong> <em>string</em> Postalcode of the Person</li>
893
+ </ul><h3>POST /person/signin</h3>
894
+
895
+ <p>Params:</p>
896
+
897
+ <ul>
898
+ <li><strong><a href="#login">login</a></strong></li>
899
+ <li><strong><a href="#password">password</a></strong></li>
900
+ </ul><p>Returns: Person <em>Hash</em></p>
901
+
902
+ <div class="highlight">
903
+ <pre> <span class="c1">// Example: POST /api/v2/person/signin</span>
904
+
905
+ <span class="p">{</span>
906
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2000-11-09T19:09:23Z"</span><span class="p">,</span>
907
+ <span class="s2">"first_name"</span><span class="o">:</span> <span class="s2">"John"</span><span class="p">,</span>
908
+ <span class="s2">"gender"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
909
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">49</span><span class="p">,</span>
910
+ <span class="s2">"last_name"</span><span class="o">:</span> <span class="s2">"Doe"</span><span class="p">,</span>
911
+ <span class="s2">"login"</span><span class="o">:</span> <span class="s2">"john@example.com"</span><span class="p">,</span>
912
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-11-09T19:09:23Z"</span><span class="p">,</span>
913
+ <span class="s2">"referral_code"</span><span class="o">:</span> <span class="s2">"fhskjfhk3j43h43hjkh"</span><span class="p">,</span>
914
+ <span class="s2">"referral_code_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
915
+ <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94104"</span>
916
+ <span class="p">}</span>
917
+ </pre>
918
+ </div>
919
+
920
+
921
+ <h3>POST /person/signup</h3>
922
+
923
+ <p>Params:</p>
924
+
925
+ <ul>
926
+ <li><strong><a href="#first_name">first_name</a></strong></li>
927
+ <li><strong><a href="#last_name">last_name</a></strong></li>
928
+ <li><strong><a href="#gender">gender</a></strong></li>
929
+ <li><strong><a href="#email">email</a></strong></li>
930
+ <li><strong><a href="#password">password</a></strong></li>
931
+ <li><strong><a href="#postalcode">postalcode</a></strong></li>
932
+ </ul><p>Returns: Person <em>Hash</em></p>
933
+
934
+ <div class="highlight">
935
+ <pre> <span class="c1">// Example: POST /api/v2/person/signup</span>
936
+
937
+ <span class="p">{</span>
938
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2000-11-09T19:09:23Z"</span><span class="p">,</span>
939
+ <span class="s2">"first_name"</span><span class="o">:</span> <span class="s2">"John"</span><span class="p">,</span>
940
+ <span class="s2">"gender"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
941
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">49</span><span class="p">,</span>
942
+ <span class="s2">"last_name"</span><span class="o">:</span> <span class="s2">"Doe"</span><span class="p">,</span>
943
+ <span class="s2">"login"</span><span class="o">:</span> <span class="s2">"john@example.com"</span><span class="p">,</span>
944
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-11-09T19:09:23Z"</span><span class="p">,</span>
945
+ <span class="s2">"referral_code"</span><span class="o">:</span> <span class="s2">"fhskjfhk3j43h43hjkh"</span><span class="p">,</span>
946
+ <span class="s2">"referral_code_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
947
+ <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94104"</span>
948
+ <span class="p">}</span>
949
+ </pre>
950
+ </div>
951
+
952
+
953
+ <h2>Venues</h2>
954
+
955
+ <p>Fields:</p>
956
+
957
+ <ul>
958
+ <li>
959
+ <strong>address1</strong> <em>string</em> First address field for the Venue</li>
960
+ <li>
961
+ <strong>address2</strong> <em>string</em> Second address field for the Venue</li>
962
+ <li>
963
+ <strong>city</strong> <em>string</em> City the Venue is in</li>
964
+ <li>
965
+ <strong>country</strong> <em>string</em> Country the Venue is in</li>
966
+ <li>
967
+ <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
968
+ <li>
969
+ <strong>id</strong> <em>integer</em> Thrillcall ID</li>
970
+ <li>
971
+ <strong>latitude</strong> <em>float</em> Approximate Latitude for the Venue</li>
972
+ <li>
973
+ <strong>longitude</strong> <em>float</em> Approximate Longitude for the Venue</li>
974
+ <li>
975
+ <strong>name</strong> <em>string</em> Name of the Venue</li>
976
+ <li>
977
+ <strong>metro_area_id</strong> <em>integer</em> Thrillcall ID of the Metro Area this Venue is in, if any</li>
978
+ <li>
979
+ <strong>state</strong> <em>string</em> State the Venue is in</li>
980
+ <li>
981
+ <strong>upcoming_events_count</strong> <em>integer</em> Number of upcoming events associated with this object</li>
982
+ <li>
983
+ <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
984
+ <li>
985
+ <strong>postalcode</strong> <em>string</em> Postal code for the Venue</li>
986
+ <li>
987
+ <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
988
+ </ul><h3>GET /venues</h3>
989
+
990
+ <p>Params:</p>
991
+
992
+ <ul>
993
+ <li><strong><a href="#limit">limit</a></strong></li>
994
+ <li><strong><a href="#page">page</a></strong></li>
995
+ <li><strong><a href="#lat">lat</a></strong></li>
996
+ <li><strong><a href="#long">long</a></strong></li>
997
+ <li><strong><a href="#postalcode">postalcode</a></strong></li>
998
+ <li><strong><a href="#radius">radius</a></strong></li>
999
+ </ul><p>Returns: <em>Array</em> of Venues <em>Hash</em></p>
1000
+
1001
+ <div class="highlight">
1002
+ <pre> <span class="c1">// Example: GET /api/v2/venues?limit=14&amp;api_key=1234567890abcdef</span>
1003
+
1004
+ <span class="p">[</span>
1005
+ <span class="p">{</span>
1006
+ <span class="s2">"address1"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1007
+ <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1008
+ <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"Guadalajara"</span><span class="p">,</span>
1009
+ <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"MX"</span><span class="p">,</span>
1010
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2000-11-09T19:09:23Z"</span><span class="p">,</span>
1011
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
1012
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1013
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1014
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Fbolko"</span><span class="p">,</span>
1015
+ <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"MX"</span><span class="p">,</span>
1016
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1017
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-28T17:24:20Z"</span><span class="p">,</span>
1018
+ <span class="s2">"postalcode"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1019
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Fbolko_in_Guadalajara_MX"</span>
1020
+ <span class="p">},</span>
1021
+ <span class="p">{</span>
1022
+ <span class="p">...</span>
1023
+ <span class="p">},</span>
1024
+ <span class="p">...</span>
1025
+ <span class="p">]</span>
1026
+ </pre>
1027
+ </div>
1028
+
1029
+
1030
+ <h3>GET /venue/:id</h3>
1031
+
1032
+ <p><strong>:id</strong> <em>integer</em> Thrillcall or Partner ID</p>
1033
+
1034
+ <p>Params:</p>
1035
+
1036
+ <ul>
1037
+ <li><strong><a href="#use_partner_id">use_partner_id</a></strong></li>
1038
+ </ul><p>Returns: Venue <em>Hash</em></p>
1039
+
1040
+ <div class="highlight">
1041
+ <pre> <span class="c1">// Example: GET /api/v2/venue/27418?api_key=1234567890abcdef</span>
1042
+
1043
+ <span class="p">{</span>
1044
+ <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"859 O'Farrell St."</span><span class="p">,</span>
1045
+ <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1046
+ <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
1047
+ <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
1048
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-21T16:52:31Z"</span><span class="p">,</span>
1049
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
1050
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.784796</span><span class="p">,</span>
1051
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.418819</span><span class="p">,</span>
1052
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Great American Music Hall"</span><span class="p">,</span>
1053
+ <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
1054
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">34</span><span class="p">,</span>
1055
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-20T21:04:37Z"</span><span class="p">,</span>
1056
+ <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94109"</span><span class="p">,</span>
1057
+ <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
1058
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"</span>
1059
+ <span class="p">}</span>
1060
+ </pre>
1061
+ </div>
1062
+
1063
+
1064
+ <h3>GET /venue/:id/events</h3>
1065
+
1066
+ <p><strong>:id</strong> <em>integer</em> Thrillcall or Partner ID</p>
1067
+
1068
+ <p>Params:</p>
1069
+
1070
+ <ul>
1071
+ <li><strong><a href="#limit">limit</a></strong></li>
1072
+ <li><strong><a href="#page">page</a></strong></li>
1073
+ <li><strong><a href="#min_date">min_date</a></strong></li>
1074
+ <li><strong><a href="#max_date">max_date</a></strong></li>
1075
+ <li><strong><a href="#use_partner_id">use_partner_id</a></strong></li>
1076
+ <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
1077
+ <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
1078
+ <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
1079
+ <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
1080
+ </ul><p>Returns: <em>Array</em> of Events <em>Hash</em></p>
1081
+
1082
+ <div class="highlight">
1083
+ <pre> <span class="c1">// Example: GET /api/v2/venue/32065/events?api_key=1234567890abcdef</span>
1084
+
1085
+ <span class="p">[</span>
1086
+ <span class="p">{</span>
1087
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2000-11-09T19:09:23Z"</span><span class="p">,</span>
1088
+ <span class="s2">"end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1089
+ <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
1090
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">824614</span><span class="p">,</span>
1091
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.8016</span><span class="p">,</span>
1092
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">80.4462</span><span class="p">,</span>
1093
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Colt Ford @ West Virginia State Fair"</span><span class="p">,</span>
1094
+ <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1095
+ <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
1096
+ <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2011-08-21T03:59:00Z"</span><span class="p">,</span>
1097
+ <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1098
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-06-24T05:10:05Z"</span><span class="p">,</span>
1099
+ <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">32065</span><span class="p">,</span>
1100
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/824614"</span>
1101
+ <span class="p">},</span>
1102
+ <span class="p">{</span>
1103
+ <span class="p">...</span>
1104
+ <span class="p">},</span>
1105
+ <span class="p">...</span>
1106
+ <span class="p">]</span>
1107
+ </pre>
1108
+ </div>
1109
+
1110
+
1111
+ <h3>GET /search/venues/:term</h3>
1112
+
1113
+ <p><strong>:term</strong> <em>string</em> Arbitrary search string on the <strong>name</strong> field. (alphanumerics only, underscore matches underscore, use '+' for space)</p>
1114
+
1115
+ <p>Params:</p>
1116
+
1117
+ <ul>
1118
+ <li><strong><a href="#limit">limit</a></strong></li>
1119
+ <li><strong><a href="#page">page</a></strong></li>
1120
+ <li><strong><a href="#lat">lat</a></strong></li>
1121
+ <li><strong><a href="#long">long</a></strong></li>
1122
+ <li><strong><a href="#postalcode">postalcode</a></strong></li>
1123
+ <li><strong><a href="#radius">radius</a></strong></li>
1124
+ </ul><p>Returns: <em>Array</em> of Venues <em>Hash</em></p>
1125
+
1126
+ <div class="highlight">
1127
+ <pre> <span class="c1">// Example: GET /api/v2/search/venues/Great%20American%20Music%20Hall?api_key=1234567890abcdef</span>
1128
+
1129
+ <span class="p">[</span>
1130
+ <span class="p">{</span>
1131
+ <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"859 O'Farrell St."</span><span class="p">,</span>
1132
+ <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1133
+ <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
1134
+ <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
1135
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-21T16:52:31Z"</span><span class="p">,</span>
1136
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
1137
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.784796</span><span class="p">,</span>
1138
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.418819</span><span class="p">,</span>
1139
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Great American Music Hall"</span><span class="p">,</span>
1140
+ <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
1141
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">34</span><span class="p">,</span>
1142
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-20T21:04:37Z"</span><span class="p">,</span>
1143
+ <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94109"</span><span class="p">,</span>
1144
+ <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
1145
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"</span>
1146
+ <span class="p">},</span>
1147
+ <span class="p">{</span>
1148
+ <span class="p">...</span>
1149
+ <span class="p">},</span>
1150
+ <span class="p">...</span>
1151
+ <span class="p">]</span>
1152
+ </pre>
1153
+ </div>
1154
+
1155
+
1156
+ <h2>Tickets</h2>
1157
+
1158
+ <p>Fields:</p>
1159
+
1160
+ <ul>
1161
+ <li>
1162
+ <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
1163
+ <li>
1164
+ <strong>description</strong> <em>string</em> Long form description of the ticket</li>
1165
+ <li>
1166
+ <strong>event_id</strong> <em>integer</em> Thrillcall Event ID</li>
1167
+ <li>
1168
+ <strong>id</strong> <em>integer</em> Thrillcall ID</li>
1169
+ <li>
1170
+ <strong>marketing_text</strong> <em>string</em> Long form description of the ticket</li>
1171
+ <li>
1172
+ <strong>max_ticket_price</strong> <em>float</em> Maximum price for this ticket</li>
1173
+ <li>
1174
+ <strong>min_ticket_price</strong> <em>float</em> Minimum price for this ticket</li>
1175
+ <li>
1176
+ <strong>name</strong> <em>string</em> Name of this ticket</li>
1177
+ <li>
1178
+ <strong>on_sale_end_date</strong> <em>string</em> YYYY-MM-DD date when the ticket goes off sale</li>
1179
+ <li>
1180
+ <strong>on_sale_start_date</strong> <em>string</em> YYYY-MM-DD date when the ticket goes on sale</li>
1181
+ <li>
1182
+ <strong>seat_info</strong> <em>string</em> Additional info about the seat</li>
1183
+ <li>
1184
+ <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
1185
+ <li>
1186
+ <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
1187
+ </ul><h3>GET /tickets</h3>
1188
+
1189
+ <p>Params:</p>
1190
+
1191
+ <ul>
1192
+ <li><strong><a href="#limit">limit</a></strong></li>
1193
+ <li><strong><a href="#page">page</a></strong></li>
1194
+ <li><strong><a href="#min_date">min_date</a></strong></li>
1195
+ <li><strong><a href="#max_date">max_date</a></strong></li>
1196
+ <li><strong><a href="#lat">lat</a></strong></li>
1197
+ <li><strong><a href="#long">long</a></strong></li>
1198
+ <li><strong><a href="#postalcode">postalcode</a></strong></li>
1199
+ <li><strong><a href="#radius">radius</a></strong></li>
1200
+ <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
1201
+ <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
1202
+ <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
1203
+ </ul><p>Returns: <em>Array</em> of Tickets <em>Hash</em></p>
1204
+
1205
+ <div class="highlight">
1206
+ <pre> <span class="c1">// Example: GET /api/v2/tickets?limit=14&amp;api_key=1234567890abcdef</span>
1207
+
1208
+ <span class="p">[</span>
1209
+ <span class="p">{</span>
1210
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-12-06T00:19:59Z"</span><span class="p">,</span>
1211
+ <span class="s2">"description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1212
+ <span class="s2">"event_id"</span><span class="o">:</span> <span class="mi">455646</span><span class="p">,</span>
1213
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
1214
+ <span class="s2">"marketing_text"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1215
+ <span class="s2">"max_ticket_price"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1216
+ <span class="s2">"min_ticket_price"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1217
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"General Onsale"</span><span class="p">,</span>
1218
+ <span class="s2">"on_sale_end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1219
+ <span class="s2">"on_sale_start_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1220
+ <span class="s2">"seat_info"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1221
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2009-09-22T22:58:37Z"</span><span class="p">,</span>
1222
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://www.livenation.com/edp/eventId/335800/?c=api-000157"</span>
1223
+ <span class="p">},</span>
1224
+ <span class="p">{</span>
1225
+ <span class="p">...</span>
1226
+ <span class="p">},</span>
1227
+ <span class="p">...</span>
1228
+ <span class="p">]</span>
1229
+ </pre>
1230
+ </div>
1231
+
1232
+
1233
+ <h3>GET /ticket/:id</h3>
1234
+
1235
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
1236
+
1237
+ <p>Params:</p>
1238
+
1239
+ <ul>
1240
+ <li>None</li>
1241
+ </ul><p>Returns: Ticket <em>Hash</em></p>
1242
+
1243
+ <div class="highlight">
1244
+ <pre> <span class="c1">// Example: GET /api/v2/ticket/599794?api_key=1234567890abcdef</span>
1245
+
1246
+ <span class="p">{</span>
1247
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:16Z"</span><span class="p">,</span>
1248
+ <span class="s2">"description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1249
+ <span class="s2">"event_id"</span><span class="o">:</span> <span class="mi">858707</span><span class="p">,</span>
1250
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">599794</span><span class="p">,</span>
1251
+ <span class="s2">"marketing_text"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1252
+ <span class="s2">"max_ticket_price"</span><span class="o">:</span> <span class="mi">21</span><span class="p">,</span>
1253
+ <span class="s2">"min_ticket_price"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1254
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Gen. Admission Seating Limited"</span><span class="p">,</span>
1255
+ <span class="s2">"on_sale_end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1256
+ <span class="s2">"on_sale_start_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1257
+ <span class="s2">"seat_info"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1258
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:16Z"</span><span class="p">,</span>
1259
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://tickets.gamh.com/evinfo.php?eventid=154723&amp;amp;r=affi&amp;amp;u=210785"</span>
1260
+ <span class="p">}</span>
1261
+ </pre>
1262
+ </div>