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/docs/README.html ADDED
@@ -0,0 +1,1382 @@
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>Thrillcall API</h1>
66
+
67
+ <p>This document describes the Thrillcall API v2, and usage for the provided Ruby API wrapper gem.</p>
68
+
69
+ <h1>Ruby API Wrapper</h1>
70
+
71
+ <h3>Usage:</h3>
72
+
73
+ <div class="highlight">
74
+ <pre> <span class="c1">#---------------------------------------------------------------#</span>
75
+ <span class="c1"># First, require the gem:</span>
76
+ <span class="c1">#---------------------------------------------------------------#</span>
77
+ <span class="nb">require</span> <span class="s1">'rubygems'</span>
78
+ <span class="nb">require</span> <span class="s1">'thrillcall-api'</span>
79
+
80
+ <span class="c1">#---------------------------------------------------------------#</span>
81
+ <span class="c1"># Instantiate with your Thrillcall API key:</span>
82
+ <span class="c1">#---------------------------------------------------------------#</span>
83
+ <span class="no">MY_API_KEY</span> <span class="o">=</span> <span class="s2">"1234567890abcdef"</span>
84
+ <span class="n">tc</span> <span class="o">=</span> <span class="no">ThrillcallAPI</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="no">MY_API_KEY</span><span class="p">)</span>
85
+
86
+ <span class="c1">#---------------------------------------------------------------#</span>
87
+ <span class="c1"># Access any endpoint directly from the instance</span>
88
+ <span class="c1">#---------------------------------------------------------------#</span>
89
+ <span class="c1"># This is like calling GET "/events"</span>
90
+ <span class="n">tc</span><span class="o">.</span><span class="n">events</span>
91
+ <span class="c1"># =&gt; [ {"id" =&gt; ... }, {...}, ...]</span>
92
+
93
+ <span class="c1">#---------------------------------------------------------------#</span>
94
+ <span class="c1"># Provide IDs as arguments</span>
95
+ <span class="c1">#---------------------------------------------------------------#</span>
96
+ <span class="c1"># GET "/event/1"</span>
97
+ <span class="n">tc</span><span class="o">.</span><span class="n">event</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
98
+ <span class="c1"># =&gt; {"id" =&gt; 1, ...}</span>
99
+
100
+ <span class="c1">#---------------------------------------------------------------#</span>
101
+ <span class="c1"># Provide parameters as arguments</span>
102
+ <span class="c1">#---------------------------------------------------------------#</span>
103
+ <span class="c1"># GET "/events?limit=5"</span>
104
+ <span class="n">events</span> <span class="o">=</span> <span class="n">tc</span><span class="o">.</span><span class="n">events</span><span class="p">(</span><span class="ss">:limit</span> <span class="o">=&gt;</span> <span class="mi">5</span><span class="p">)</span>
105
+ <span class="c1"># =&gt; [ {"id" =&gt; ... }, {...}, ...]</span>
106
+ <span class="n">events</span><span class="o">.</span><span class="n">length</span>
107
+ <span class="c1"># =&gt; 5</span>
108
+
109
+ <span class="c1">#---------------------------------------------------------------#</span>
110
+ <span class="c1"># Chain methods together for nested routes</span>
111
+ <span class="c1">#---------------------------------------------------------------#</span>
112
+ <span class="c1"># GET "/search/venues/warfield?postalcode=94101&amp;radius=20"</span>
113
+ <span class="n">venues</span> <span class="o">=</span> <span class="n">tc</span><span class="o">.</span><span class="n">search</span><span class="o">.</span><span class="n">venues</span><span class="p">(</span><span class="s2">"warfield"</span><span class="p">,</span> <span class="ss">:postalcode</span> <span class="o">=&gt;</span> <span class="s2">"94101"</span><span class="p">,</span> <span class="ss">:radius</span> <span class="o">=&gt;</span> <span class="mi">20</span><span class="p">)</span>
114
+ <span class="c1"># =&gt; [{"name" =&gt; "The Warfield", ...}]</span>
115
+ </pre>
116
+ </div>
117
+
118
+
119
+ <h3>Advanced Usage:</h3>
120
+
121
+ <p>Provide additional instantiation options:</p>
122
+
123
+ <div class="highlight">
124
+ <pre> <span class="c1">#---------------------------------------------------------------#</span>
125
+ <span class="c1"># The default SSL endpoint is "https://api.thrillcall.com/api/".</span>
126
+ <span class="c1"># The default API version is 2.</span>
127
+ <span class="c1"># By default, Faraday access logging is turned off.</span>
128
+ <span class="c1"># Override if necessary:</span>
129
+ <span class="c1">#---------------------------------------------------------------#</span>
130
+ <span class="n">tc</span> <span class="o">=</span> <span class="no">ThrillcallAPI</span><span class="o">.</span><span class="n">new</span><span class="p">(</span>
131
+ <span class="no">MY_API_KEY</span><span class="p">,</span>
132
+ <span class="ss">:base_url</span> <span class="o">=&gt;</span> <span class="s2">"https://api.thrillcall.com/custom/"</span><span class="p">,</span>
133
+ <span class="ss">:version</span> <span class="o">=&gt;</span> <span class="mi">3</span><span class="p">,</span>
134
+ <span class="ss">:logger</span> <span class="o">=&gt;</span> <span class="kp">true</span>
135
+ <span class="p">)</span>
136
+ </pre>
137
+ </div>
138
+
139
+
140
+ <p>Internally, the wrapper returns a ThrillcallAPI::Result class for any call. Data for the request is fetched only when used. This allows you to build requests piecemeal before executing them.</p>
141
+
142
+ <div class="highlight">
143
+ <pre> <span class="c1">#---------------------------------------------------------------#</span>
144
+ <span class="c1"># Build a partial request, add on to it later</span>
145
+ <span class="c1">#---------------------------------------------------------------#</span>
146
+ <span class="n">request</span> <span class="o">=</span> <span class="n">tc</span><span class="o">.</span><span class="n">artist</span><span class="p">(</span><span class="mi">22210</span><span class="p">)</span> <span class="c1"># Lady Gaga</span>
147
+
148
+ <span class="c1"># GET "/artist/22210/events?limit=2"</span>
149
+ <span class="n">artist_events</span> <span class="o">=</span> <span class="n">request</span><span class="o">.</span><span class="n">events</span><span class="p">(</span><span class="ss">:limit</span> <span class="o">=&gt;</span> <span class="mi">2</span><span class="p">)</span>
150
+
151
+ <span class="n">artist_events</span><span class="o">.</span><span class="n">length</span>
152
+ <span class="c1"># =&gt; 2</span>
153
+ </pre>
154
+ </div>
155
+
156
+
157
+ <p>This gem is a convenience wrapper around the excellent Faraday project. If more complicated use cases are necessary, consider using Faraday directly.</p>
158
+
159
+ <div class="highlight">
160
+ <pre> <span class="nb">require</span> <span class="s1">'faraday'</span>
161
+ <span class="nb">require</span> <span class="s1">'json'</span>
162
+
163
+ <span class="no">MY_API_KEY</span> <span class="o">=</span> <span class="s2">"1234567890abcdef"</span>
164
+ <span class="no">BASE_URL</span> <span class="o">=</span> <span class="s2">"https://api.thrillcall.com/api/v2/"</span>
165
+ <span class="no">HEADERS</span> <span class="o">=</span> <span class="p">{</span> <span class="ss">:accept</span> <span class="o">=&gt;</span> <span class="s1">'application/json'</span> <span class="p">}</span>
166
+
167
+ <span class="n">connection</span> <span class="o">=</span> <span class="no">Faraday</span><span class="o">.</span><span class="n">new</span><span class="p">(</span> <span class="ss">:url</span> <span class="o">=&gt;</span> <span class="no">BASE_URL</span><span class="p">,</span> <span class="ss">:headers</span> <span class="o">=&gt;</span> <span class="no">HEADERS</span> <span class="p">)</span> <span class="k">do</span> <span class="o">|</span><span class="n">builder</span><span class="o">|</span>
168
+ <span class="n">builder</span><span class="o">.</span><span class="n">adapter</span> <span class="no">Faraday</span><span class="o">.</span><span class="n">default_adapter</span>
169
+ <span class="n">builder</span><span class="o">.</span><span class="n">response</span> <span class="ss">:logger</span>
170
+ <span class="n">builder</span><span class="o">.</span><span class="n">response</span> <span class="ss">:raise_error</span>
171
+ <span class="k">end</span>
172
+
173
+ <span class="n">request</span> <span class="o">=</span> <span class="n">connection</span><span class="o">.</span><span class="n">get</span> <span class="k">do</span> <span class="o">|</span><span class="n">req</span><span class="o">|</span>
174
+ <span class="n">req</span><span class="o">.</span><span class="n">url</span> <span class="s2">"artist/22210"</span><span class="p">,</span> <span class="p">{</span> <span class="ss">:api_key</span> <span class="o">=&gt;</span> <span class="no">MY_API_KEY</span> <span class="p">}</span>
175
+ <span class="k">end</span>
176
+
177
+ <span class="n">artist</span> <span class="o">=</span> <span class="no">JSON</span><span class="o">.</span><span class="n">parse</span><span class="p">(</span><span class="n">request</span><span class="o">.</span><span class="n">body</span><span class="p">)</span>
178
+
179
+ <span class="n">artist</span><span class="o">[</span><span class="s2">"name"</span><span class="o">]</span>
180
+ <span class="c1"># =&gt; "Lady Gaga"</span>
181
+ </pre>
182
+ </div>
183
+
184
+
185
+ <h1>HTTPS Endpoints</h1>
186
+
187
+ <h3>SSL/TLS Endpoints Required:</h3>
188
+
189
+ <p>All API access must use the secure HTTPS endpoint : https://api.thrillcall.com:443
190
+ Access over an insecure HTTP (port 80) endpoint is now deprecated and will be disabled.</p>
191
+
192
+ <h3>Parameters</h3>
193
+
194
+ <p>These are valid parameters for any endpoint, however, they will only be used by the server where applicable.</p>
195
+
196
+ <p><strong>api_key</strong> MUST BE SUPPLIED for every endpoint.</p>
197
+
198
+ <ul>
199
+ <li>
200
+ <p><a name="api_key"></a><strong>api_key</strong> <em>string: (format: length == 16)</em></p>
201
+
202
+ <p>Your API key. Required for access to any endpoint.</p>
203
+ </li>
204
+ <li>
205
+ <p><a name="limit"></a><strong>limit</strong> <em>integer</em></p>
206
+
207
+ <p><em>Default: 100</em></p>
208
+
209
+ <p>Sets the maximum number of results to return. Cannot be above 100.</p>
210
+ </li>
211
+ <li>
212
+ <p><a name="page"></a><strong>page</strong> <em>integer</em></p>
213
+
214
+ <p><em>Default: 0</em></p>
215
+
216
+ <p>Used in conjunction with <strong><a href="#limit">limit</a></strong>.</p>
217
+
218
+ <p>Specifies the page number. If limit is 10, then page = 2 will return results #20 through #29</p>
219
+ </li>
220
+ <li>
221
+ <p><a name="min_date"></a><strong>min_date</strong> <em>string (format: "YYYY-MM-DD")</em></p>
222
+
223
+ <p><em>Default: Today</em></p>
224
+
225
+ <p>Results before this date will not be returned.</p>
226
+ </li>
227
+ <li>
228
+ <p><a name="max_date"></a><strong>max_date</strong> <em>string (format: "YYYY-MM-DD")</em></p>
229
+
230
+ <p><em>Default: 1 year from Today</em></p>
231
+
232
+ <p>Results after this date will not be returned.</p>
233
+ </li>
234
+ <li>
235
+ <p><a name="lat"></a><strong>lat</strong> <em>float</em></p>
236
+
237
+ <p><em>Default: none</em></p>
238
+
239
+ <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>
240
+ </li>
241
+ <li>
242
+ <p><a name="long"></a><strong>long</strong> <em>float</em></p>
243
+
244
+ <p><em>Default: none</em></p>
245
+
246
+ <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>
247
+ </li>
248
+ <li>
249
+ <p><a name="postalcode"></a><strong>postalcode</strong> <em>string (format: length &gt;= 5)</em></p>
250
+
251
+ <p><em>Default: none</em></p>
252
+
253
+ <p>Results will be within the <strong><a href="#radius">radius</a></strong> of this postal code.
254
+ 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>
255
+ </li>
256
+ <li>
257
+ <p><a name="radius"></a><strong>radius</strong> <em>float</em></p>
258
+
259
+ <p><em>Default: 100.0</em></p>
260
+
261
+ <p>Used in conjunction with <strong><a href="#postalcode">postalcode</a></strong></p>
262
+ </li>
263
+ <li>
264
+ <p><a name="use_partner_id"></a><strong>use_partner_id</strong> <em>boolean</em></p>
265
+
266
+ <p><em>Default: false</em></p>
267
+
268
+ <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>
269
+
270
+ <p>Contact us to set up a list of definitions.</p>
271
+ </li>
272
+ <li>
273
+ <p><a name="ticket_type"></a><strong>ticket_type</strong> <em>string (format: "primary" or "resale")</em></p>
274
+
275
+ <p><em>Default: both</em></p>
276
+
277
+ <p>If specified, will only return tickets from Primary or Resale merchants.</p>
278
+ </li>
279
+ <li>
280
+ <p><a name="must_have_tickets"></a><strong>must_have_tickets</strong> <em>boolean</em></p>
281
+
282
+ <p><em>Default: false</em></p>
283
+
284
+ <p>If set to <em>true</em> or <em>1</em>, will only return results that have tickets associated with them.</p>
285
+ </li>
286
+ <li>
287
+ <p><a name="show_unconfirmed_events"></a><strong>show_unconfirmed_events</strong> <em>boolean</em></p>
288
+
289
+ <p><em>Default: false</em></p>
290
+
291
+ <p>If set to <em>true</em> or <em>1</em>, will not filter out events with unconfirmed locations.</p>
292
+ </li>
293
+ <li>
294
+ <p><a name="show_rumor_events"></a><strong>show_rumor_events</strong> <em>boolean</em></p>
295
+
296
+ <p><em>Default: false</em></p>
297
+
298
+ <p>If set to <em>true</em> or <em>1</em>, will not filter out events marked as rumored.</p>
299
+ </li>
300
+ <li>
301
+ <p><a name="primary_genre_id"></a><strong>primary_genre_id</strong> <em>integer</em></p>
302
+
303
+ <p><em>Default: none</em></p>
304
+
305
+ <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>
306
+ </li>
307
+ <li>
308
+ <p><a name="login"></a><strong>login</strong> <em>string</em></p>
309
+
310
+ <p>Required to authenticate/register a user.</p>
311
+ </li>
312
+ <li>
313
+ <p><a name="password"></a><strong>password</strong> <em>string (format: 40 &gt;= length &gt;= 5)</em></p>
314
+
315
+ <p>Required to authenticate/register a user.</p>
316
+ </li>
317
+ <li>
318
+ <p><a name="first_name"></a><strong>first_name</strong> <em>string (format: 50 &gt;= length &gt;= 2)</em></p>
319
+
320
+ <p>Required to register a user.</p>
321
+ </li>
322
+ <li>
323
+ <p><a name="last_name"></a><strong>last_name</strong> <em>string (format: 50 &gt;= length &gt;= 2)</em></p>
324
+
325
+ <p>Optional for registering a user.</p>
326
+ </li>
327
+ <li>
328
+ <p><a name="email"></a><strong>email</strong> <em>string</em></p>
329
+
330
+ <p>Required to register a user.</p>
331
+ </li>
332
+ <li>
333
+ <p><a name="gender"></a><strong>gender</strong> <em>string (format: length == 1)</em></p>
334
+
335
+ <p>Optional for registering a user.</p>
336
+ </li>
337
+ </ul><h2>Artists</h2>
338
+
339
+ <p>Fields:</p>
340
+
341
+ <ul>
342
+ <li>
343
+ <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
344
+ <li>
345
+ <strong>genre_tags</strong> <em>string</em> Semicolon separated list of Genre names</li>
346
+ <li>
347
+ <strong>id</strong> <em>integer</em> Thrillcall ID</li>
348
+ <li>
349
+ <strong>name</strong> <em>string</em> Artist / Band Name</li>
350
+ <li>
351
+ <strong>primary_genre_id</strong> <em>integer</em> The Thrillcall ID for this artist's primary Genre</li>
352
+ <li>
353
+ <strong>upcoming_events_count</strong> <em>integer</em> Number of upcoming events associated with this object</li>
354
+ <li>
355
+ <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
356
+ <li>
357
+ <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
358
+ </ul><h3>GET /artists</h3>
359
+
360
+ <p>Params:</p>
361
+
362
+ <ul>
363
+ <li><strong><a href="#limit">limit</a></strong></li>
364
+ <li><strong><a href="#page">page</a></strong></li>
365
+ <li><strong><a href="#primary_genre_id">primary_genre_id</a></strong></li>
366
+ </ul><p>Returns: <em>Array</em> of Artists <em>Hash</em></p>
367
+
368
+ <div class="highlight">
369
+ <pre> <span class="c1">// Example: GET /api/v2/artists?limit=14&amp;api_key=1234567890abcdef</span>
370
+
371
+ <span class="p">[</span>
372
+ <span class="p">{</span>
373
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-29T10:19:45Z"</span><span class="p">,</span>
374
+ <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"O"</span><span class="p">,</span>
375
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
376
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Hyler Jones Proteges"</span><span class="p">,</span>
377
+ <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">61</span><span class="p">,</span>
378
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
379
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-26T16:49:20Z"</span><span class="p">,</span>
380
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Hyler_Jones_Proteges"</span>
381
+ <span class="p">},</span>
382
+ <span class="p">{</span>
383
+ <span class="p">...</span>
384
+ <span class="p">},</span>
385
+ <span class="p">...</span>
386
+ <span class="p">]</span>
387
+ </pre>
388
+ </div>
389
+
390
+
391
+ <h3>GET /artist/:id</h3>
392
+
393
+ <p><strong>:id</strong> <em>integer</em> Thrillcall or Partner ID</p>
394
+
395
+ <p>Params:</p>
396
+
397
+ <ul>
398
+ <li><strong><a href="#use_partner_id">use_partner_id</a></strong></li>
399
+ </ul><p>Returns: Artist <em>Hash</em></p>
400
+
401
+ <div class="highlight">
402
+ <pre> <span class="c1">// Example: GET /api/v2/artist/4802?api_key=1234567890abcdef</span>
403
+
404
+ <span class="p">{</span>
405
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-28T18:56:09Z"</span><span class="p">,</span>
406
+ <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Rock"</span><span class="p">,</span>
407
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">4802</span><span class="p">,</span>
408
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"The Sea and Cake"</span><span class="p">,</span>
409
+ <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
410
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">8</span><span class="p">,</span>
411
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-20T19:12:57Z"</span><span class="p">,</span>
412
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/The_Sea_and_Cake"</span>
413
+ <span class="p">}</span>
414
+ </pre>
415
+ </div>
416
+
417
+
418
+ <h3>GET /artist/:id/events</h3>
419
+
420
+ <p><strong>:id</strong> <em>integer</em> Thrillcall or Partner ID</p>
421
+
422
+ <p>Params:</p>
423
+
424
+ <ul>
425
+ <li><strong><a href="#limit">limit</a></strong></li>
426
+ <li><strong><a href="#page">page</a></strong></li>
427
+ <li><strong><a href="#min_date">min_date</a></strong></li>
428
+ <li><strong><a href="#max_date">max_date</a></strong></li>
429
+ <li><strong><a href="#lat">lat</a></strong></li>
430
+ <li><strong><a href="#long">long</a></strong></li>
431
+ <li><strong><a href="#postalcode">postalcode</a></strong></li>
432
+ <li><strong><a href="#radius">radius</a></strong></li>
433
+ <li><strong><a href="#use_partner_id">use_partner_id</a></strong></li>
434
+ <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
435
+ <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
436
+ <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
437
+ <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
438
+ </ul><p>Returns: <em>Array</em> of Events <em>Hash</em></p>
439
+
440
+ <div class="highlight">
441
+ <pre> <span class="c1">// Example: GET /api/v2/artist/4802/events?api_key=1234567890abcdef</span>
442
+
443
+ <span class="p">[</span>
444
+ <span class="p">{</span>
445
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-23T23:10:31Z"</span><span class="p">,</span>
446
+ <span class="s2">"end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
447
+ <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
448
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">862618</span><span class="p">,</span>
449
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">30.2729</span><span class="p">,</span>
450
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">97.7405</span><span class="p">,</span>
451
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"The Sea and Cake @ The Mohawk"</span><span class="p">,</span>
452
+ <span class="s2">"num_cancelled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
453
+ <span class="s2">"num_confirmed_bookings"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
454
+ <span class="s2">"num_disabled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
455
+ <span class="s2">"num_unconfirmed_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
456
+ <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
457
+ <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
458
+ <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2011-12-09T05:59:00Z"</span><span class="p">,</span>
459
+ <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
460
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T04:01:56Z"</span><span class="p">,</span>
461
+ <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">10116</span><span class="p">,</span>
462
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/862618"</span>
463
+ <span class="p">},</span>
464
+ <span class="p">{</span>
465
+ <span class="p">...</span>
466
+ <span class="p">},</span>
467
+ <span class="p">...</span>
468
+ <span class="p">]</span>
469
+ </pre>
470
+ </div>
471
+
472
+
473
+ <h3>GET /search/artists/:term</h3>
474
+
475
+ <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>
476
+
477
+ <p>Params:</p>
478
+
479
+ <ul>
480
+ <li><strong><a href="#limit">limit</a></strong></li>
481
+ <li><strong><a href="#page">page</a></strong></li>
482
+ </ul><p>Returns: <em>Array</em> of Artists <em>Hash</em></p>
483
+
484
+ <div class="highlight">
485
+ <pre> <span class="c1">// Example: GET /api/v2/search/artists/The%20Sea%20and%20Cake?api_key=1234567890abcdef</span>
486
+
487
+ <span class="p">[</span>
488
+ <span class="p">{</span>
489
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-28T18:56:09Z"</span><span class="p">,</span>
490
+ <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Rock"</span><span class="p">,</span>
491
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">4802</span><span class="p">,</span>
492
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"The Sea and Cake"</span><span class="p">,</span>
493
+ <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
494
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">8</span><span class="p">,</span>
495
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-20T19:12:57Z"</span><span class="p">,</span>
496
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/The_Sea_and_Cake"</span>
497
+ <span class="p">},</span>
498
+ <span class="p">{</span>
499
+ <span class="p">...</span>
500
+ <span class="p">},</span>
501
+ <span class="p">...</span>
502
+ <span class="p">]</span>
503
+ </pre>
504
+ </div>
505
+
506
+
507
+ <h2>Events</h2>
508
+
509
+ <p>Fields:</p>
510
+
511
+ <ul>
512
+ <li>
513
+ <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
514
+ <li>
515
+ <strong>end_date</strong> <em>string</em> ISO 8601 representation of the end of the Event</li>
516
+ <li>
517
+ <strong>festival</strong> <em>boolean</em> Is this event a festival?</li>
518
+ <li>
519
+ <strong>id</strong> <em>integer</em> Thrillcall ID</li>
520
+ <li>
521
+ <strong>latitude</strong> <em>float</em> Approximate latitude for the Event</li>
522
+ <li>
523
+ <strong>longitude</strong> <em>float</em> Approximate longitude for the Event</li>
524
+ <li>
525
+ <strong>name</strong> <em>string</em> Name of the Event</li>
526
+ <li>
527
+ <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>
528
+ <li>
529
+ <strong>num_unconfirmed_bookings</strong> <em>integer</em> The number of unconfirmed Artist bookings for this event</li>
530
+ <li>
531
+ <strong>num_disabled_bookings</strong> <em>integer</em> The number of disabled Artist bookings for this event</li>
532
+ <li>
533
+ <strong>num_cancelled_bookings</strong> <em>integer</em> The number of cancelled Artist bookings for this event</li>
534
+ <li>
535
+ <strong>on_sale_date</strong> <em>string</em> ISO 8601 representation of the date when tickets go on sale</li>
536
+ <li>
537
+ <strong>rumor</strong> <em>boolean</em> Are the details for this event based on a rumor?</li>
538
+ <li>
539
+ <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>
540
+ <li>
541
+ <strong>unconfirmed_location</strong> <em>integer</em> If 1, the location if this event is unconfirmed</li>
542
+ <li>
543
+ <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
544
+ <li>
545
+ <strong>venue_id</strong> <em>integer</em> Thrillcall Venue ID</li>
546
+ <li>
547
+ <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
548
+ </ul><h3>GET /events</h3>
549
+
550
+ <p>Params:</p>
551
+
552
+ <ul>
553
+ <li><strong><a href="#limit">limit</a></strong></li>
554
+ <li><strong><a href="#page">page</a></strong></li>
555
+ <li><strong><a href="#min_date">min_date</a></strong></li>
556
+ <li><strong><a href="#max_date">max_date</a></strong></li>
557
+ <li><strong><a href="#lat">lat</a></strong></li>
558
+ <li><strong><a href="#long">long</a></strong></li>
559
+ <li><strong><a href="#postalcode">postalcode</a></strong></li>
560
+ <li><strong><a href="#radius">radius</a></strong></li>
561
+ <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
562
+ <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
563
+ <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
564
+ <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
565
+ </ul><p>Returns: <em>Array</em> of Events <em>Hash</em></p>
566
+
567
+ <div class="highlight">
568
+ <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>
569
+
570
+ <span class="p">[</span>
571
+ <span class="p">{</span>
572
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:13Z"</span><span class="p">,</span>
573
+ <span class="s2">"end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
574
+ <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
575
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">858707</span><span class="p">,</span>
576
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7951</span><span class="p">,</span>
577
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.421</span><span class="p">,</span>
578
+ <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>
579
+ <span class="s2">"num_cancelled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
580
+ <span class="s2">"num_confirmed_bookings"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
581
+ <span class="s2">"num_disabled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
582
+ <span class="s2">"num_unconfirmed_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
583
+ <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
584
+ <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
585
+ <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2011-12-06T07:59:00Z"</span><span class="p">,</span>
586
+ <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
587
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T04:00:41Z"</span><span class="p">,</span>
588
+ <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
589
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/858707"</span>
590
+ <span class="p">},</span>
591
+ <span class="p">{</span>
592
+ <span class="p">...</span>
593
+ <span class="p">},</span>
594
+ <span class="p">...</span>
595
+ <span class="p">]</span>
596
+ </pre>
597
+ </div>
598
+
599
+
600
+ <h3>GET /event/:id</h3>
601
+
602
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
603
+
604
+ <p>Params:</p>
605
+
606
+ <ul>
607
+ <li>None</li>
608
+ </ul><p>Returns: Event <em>Hash</em></p>
609
+
610
+ <div class="highlight">
611
+ <pre> <span class="c1">// Example: GET /api/v2/event/858707?api_key=1234567890abcdef</span>
612
+
613
+ <span class="p">{</span>
614
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:13Z"</span><span class="p">,</span>
615
+ <span class="s2">"end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
616
+ <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
617
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">858707</span><span class="p">,</span>
618
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7951</span><span class="p">,</span>
619
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.421</span><span class="p">,</span>
620
+ <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>
621
+ <span class="s2">"num_cancelled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
622
+ <span class="s2">"num_confirmed_bookings"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
623
+ <span class="s2">"num_disabled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
624
+ <span class="s2">"num_unconfirmed_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
625
+ <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
626
+ <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
627
+ <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2011-12-06T07:59:00Z"</span><span class="p">,</span>
628
+ <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
629
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T04:00:41Z"</span><span class="p">,</span>
630
+ <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
631
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/858707"</span>
632
+ <span class="p">}</span>
633
+ </pre>
634
+ </div>
635
+
636
+
637
+ <h3>GET /event/:id/artists</h3>
638
+
639
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
640
+
641
+ <p>Params:</p>
642
+
643
+ <ul>
644
+ <li><strong><a href="#limit">limit</a></strong></li>
645
+ <li><strong><a href="#page">page</a></strong></li>
646
+ </ul><p>Returns: <em>Array</em> of Artists <em>Hash</em></p>
647
+
648
+ <div class="highlight">
649
+ <pre> <span class="c1">// Example: GET /api/v2/event/858707/artists?api_key=1234567890abcdef</span>
650
+
651
+ <span class="p">[</span>
652
+ <span class="p">{</span>
653
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-28T18:56:09Z"</span><span class="p">,</span>
654
+ <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Rock"</span><span class="p">,</span>
655
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">4802</span><span class="p">,</span>
656
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"The Sea and Cake"</span><span class="p">,</span>
657
+ <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
658
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">8</span><span class="p">,</span>
659
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-20T19:12:57Z"</span><span class="p">,</span>
660
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/The_Sea_and_Cake"</span>
661
+ <span class="p">},</span>
662
+ <span class="p">{</span>
663
+ <span class="p">...</span>
664
+ <span class="p">},</span>
665
+ <span class="p">...</span>
666
+ <span class="p">]</span>
667
+ </pre>
668
+ </div>
669
+
670
+
671
+ <h3>GET /event/:id/venue</h3>
672
+
673
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
674
+
675
+ <p>Params:</p>
676
+
677
+ <ul>
678
+ <li>None</li>
679
+ </ul><p>Returns: Venue <em>Hash</em></p>
680
+
681
+ <div class="highlight">
682
+ <pre> <span class="c1">// Example: GET /api/v2/event/858707/venue?api_key=1234567890abcdef</span>
683
+
684
+ <span class="p">{</span>
685
+ <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"859 O'Farrell St."</span><span class="p">,</span>
686
+ <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
687
+ <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
688
+ <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
689
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-21T16:52:31Z"</span><span class="p">,</span>
690
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
691
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.784796</span><span class="p">,</span>
692
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.418819</span><span class="p">,</span>
693
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Great American Music Hall"</span><span class="p">,</span>
694
+ <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
695
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">34</span><span class="p">,</span>
696
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-20T21:04:37Z"</span><span class="p">,</span>
697
+ <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94109"</span><span class="p">,</span>
698
+ <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
699
+ <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>
700
+ <span class="p">}</span>
701
+ </pre>
702
+ </div>
703
+
704
+
705
+ <h3>GET /event/:id/tickets</h3>
706
+
707
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
708
+
709
+ <p>Params:</p>
710
+
711
+ <ul>
712
+ <li><strong><a href="#limit">limit</a></strong></li>
713
+ <li><strong><a href="#page">page</a></strong></li>
714
+ <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
715
+ </ul><p>Returns: <em>Array</em> of Tickets <em>Hash</em></p>
716
+
717
+ <div class="highlight">
718
+ <pre> <span class="c1">// Example: GET /api/v2/event/858707/tickets?api_key=1234567890abcdef</span>
719
+
720
+ <span class="p">[</span>
721
+ <span class="p">{</span>
722
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:16Z"</span><span class="p">,</span>
723
+ <span class="s2">"description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
724
+ <span class="s2">"event_id"</span><span class="o">:</span> <span class="mi">858707</span><span class="p">,</span>
725
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">599794</span><span class="p">,</span>
726
+ <span class="s2">"marketing_text"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
727
+ <span class="s2">"max_ticket_price"</span><span class="o">:</span> <span class="mi">21</span><span class="p">,</span>
728
+ <span class="s2">"min_ticket_price"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
729
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Gen. Admission Seating Limited"</span><span class="p">,</span>
730
+ <span class="s2">"on_sale_end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
731
+ <span class="s2">"on_sale_start_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
732
+ <span class="s2">"seat_info"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
733
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:16Z"</span><span class="p">,</span>
734
+ <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>
735
+ <span class="p">},</span>
736
+ <span class="p">{</span>
737
+ <span class="p">...</span>
738
+ <span class="p">},</span>
739
+ <span class="p">...</span>
740
+ <span class="p">]</span>
741
+ </pre>
742
+ </div>
743
+
744
+
745
+ <h2>Genre</h2>
746
+
747
+ <p>Fields:</p>
748
+
749
+ <ul>
750
+ <li>
751
+ <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
752
+ <li>
753
+ <strong>description</strong> <em>string</em> Description of the Genre</li>
754
+ <li>
755
+ <strong>id</strong> <em>integer</em> Thrillcall ID</li>
756
+ <li>
757
+ <strong>name</strong> <em>string</em> Name of the Genre</li>
758
+ <li>
759
+ <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
760
+ </ul><h3>GET /genres</h3>
761
+
762
+ <p>Params:</p>
763
+
764
+ <ul>
765
+ <li><strong><a href="#limit">limit</a></strong></li>
766
+ <li><strong><a href="#page">page</a></strong></li>
767
+ </ul><p>Returns: <em>Array</em> of Genres <em>Hash</em></p>
768
+
769
+ <div class="highlight">
770
+ <pre> <span class="c1">// Example: GET /api/v2/genres?limit=14&amp;api_key=1234567890abcdef</span>
771
+
772
+ <span class="p">[</span>
773
+ <span class="p">{</span>
774
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-07-09T19:17:45Z"</span><span class="p">,</span>
775
+ <span class="s2">"description"</span><span class="o">:</span> <span class="s2">"Shawn Colvin, Loudon Wainwright III etc..."</span><span class="p">,</span>
776
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">6</span><span class="p">,</span>
777
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Folk"</span><span class="p">,</span>
778
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-25T23:51:55Z"</span>
779
+ <span class="p">},</span>
780
+ <span class="p">{</span>
781
+ <span class="p">...</span>
782
+ <span class="p">},</span>
783
+ <span class="p">...</span>
784
+ <span class="p">]</span>
785
+ </pre>
786
+ </div>
787
+
788
+
789
+ <h3>GET /genre/:id</h3>
790
+
791
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
792
+
793
+ <p>Params:</p>
794
+
795
+ <ul>
796
+ <li>None</li>
797
+ </ul><p>Returns: Genre <em>Hash</em></p>
798
+
799
+ <div class="highlight">
800
+ <pre> <span class="c1">// Example: GET /api/v2/genre/27?api_key=1234567890abcdef</span>
801
+
802
+ <span class="p">{</span>
803
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-07-09T19:17:45Z"</span><span class="p">,</span>
804
+ <span class="s2">"description"</span><span class="o">:</span> <span class="s2">"U2, 30 Seconds To Mars etc..."</span><span class="p">,</span>
805
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
806
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Rock"</span><span class="p">,</span>
807
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-25T23:52:21Z"</span>
808
+ <span class="p">}</span>
809
+ </pre>
810
+ </div>
811
+
812
+
813
+ <h3>GET /genre/:id/artists</h3>
814
+
815
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
816
+
817
+ <p>Params:</p>
818
+
819
+ <ul>
820
+ <li><strong><a href="#limit">limit</a></strong></li>
821
+ <li><strong><a href="#page">page</a></strong></li>
822
+ </ul><p>Returns: <em>Array</em> of Artists <em>Hash</em></p>
823
+
824
+ <div class="highlight">
825
+ <pre> <span class="c1">// Example: GET /api/v2/genre/27/artists?api_key=1234567890abcdef</span>
826
+
827
+ <span class="p">[</span>
828
+ <span class="p">{</span>
829
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-29T10:06:05Z"</span><span class="p">,</span>
830
+ <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Folk;Other;psychedelic"</span><span class="p">,</span>
831
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">2</span><span class="p">,</span>
832
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Espers"</span><span class="p">,</span>
833
+ <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
834
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
835
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-03T22:14:36Z"</span><span class="p">,</span>
836
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Espers"</span>
837
+ <span class="p">},</span>
838
+ <span class="p">{</span>
839
+ <span class="p">...</span>
840
+ <span class="p">},</span>
841
+ <span class="p">...</span>
842
+ <span class="p">]</span>
843
+ </pre>
844
+ </div>
845
+
846
+
847
+ <h2>Metro Area</h2>
848
+
849
+ <p>Fields:</p>
850
+
851
+ <ul>
852
+ <li>
853
+ <strong>city</strong> <em>string</em> City of the Metro Area</li>
854
+ <li>
855
+ <strong>country</strong> <em>string</em> Country of the Metro Area</li>
856
+ <li>
857
+ <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
858
+ <li>
859
+ <strong>id</strong> <em>integer</em> Thrillcall ID</li>
860
+ <li>
861
+ <strong>latitude</strong> <em>float</em> Latitude of the Metro Area</li>
862
+ <li>
863
+ <strong>longitude</strong> <em>float</em> Longitude of the Metro Area</li>
864
+ <li>
865
+ <strong>radius</strong> <em>integer</em> Radius of the Metro Area from the Lat/Long center</li>
866
+ <li>
867
+ <strong>state</strong> <em>string</em> State of the Metro Area</li>
868
+ <li>
869
+ <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
870
+ <li>
871
+ <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
872
+ </ul><h3>GET /metro_areas</h3>
873
+
874
+ <p>Params:</p>
875
+
876
+ <ul>
877
+ <li><strong><a href="#limit">limit</a></strong></li>
878
+ <li><strong><a href="#page">page</a></strong></li>
879
+ </ul><p>Returns: <em>Array</em> of Metro Areas <em>Hash</em></p>
880
+
881
+ <div class="highlight">
882
+ <pre> <span class="c1">// Example: GET /api/v2/metro_areas?limit=14&amp;api_key=1234567890abcdef</span>
883
+
884
+ <span class="p">[</span>
885
+ <span class="p">{</span>
886
+ <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"Chicago"</span><span class="p">,</span>
887
+ <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
888
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-24T03:23:57Z"</span><span class="p">,</span>
889
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">104</span><span class="p">,</span>
890
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">41.8842</span><span class="p">,</span>
891
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">87.6324</span><span class="p">,</span>
892
+ <span class="s2">"radius"</span><span class="o">:</span> <span class="mi">50</span><span class="p">,</span>
893
+ <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"IL"</span><span class="p">,</span>
894
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-07-05T23:11:24Z"</span><span class="p">,</span>
895
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/live-music/chicago"</span>
896
+ <span class="p">},</span>
897
+ <span class="p">{</span>
898
+ <span class="p">...</span>
899
+ <span class="p">},</span>
900
+ <span class="p">...</span>
901
+ <span class="p">]</span>
902
+ </pre>
903
+ </div>
904
+
905
+
906
+ <h3>GET /metro_area/:id</h3>
907
+
908
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
909
+
910
+ <p>Params:</p>
911
+
912
+ <ul>
913
+ <li>None</li>
914
+ </ul><p>Returns: Metro Area <em>Hash</em></p>
915
+
916
+ <div class="highlight">
917
+ <pre> <span class="c1">// Example: GET /api/v2/metro_area/105?api_key=1234567890abcdef</span>
918
+
919
+ <span class="p">{</span>
920
+ <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
921
+ <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
922
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-24T03:23:57Z"</span><span class="p">,</span>
923
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
924
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7771</span><span class="p">,</span>
925
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.42</span><span class="p">,</span>
926
+ <span class="s2">"radius"</span><span class="o">:</span> <span class="mi">50</span><span class="p">,</span>
927
+ <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
928
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-07-05T23:11:24Z"</span><span class="p">,</span>
929
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/live-music/san-francisco"</span>
930
+ <span class="p">}</span>
931
+ </pre>
932
+ </div>
933
+
934
+
935
+ <h3>GET /metro_area/:id/events</h3>
936
+
937
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
938
+
939
+ <p>Params:</p>
940
+
941
+ <ul>
942
+ <li><strong><a href="#limit">limit</a></strong></li>
943
+ <li><strong><a href="#page">page</a></strong></li>
944
+ <li><strong><a href="#min_date">min_date</a></strong></li>
945
+ <li><strong><a href="#max_date">max_date</a></strong></li>
946
+ <li><strong><a href="#radius">radius</a></strong></li>
947
+ <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
948
+ <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
949
+ <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
950
+ <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
951
+ </ul><p>Returns: <em>Array</em> of Metro Areas <em>Hash</em></p>
952
+
953
+ <div class="highlight">
954
+ <pre> <span class="c1">// Example: GET /api/v2/metro_area/105/events?api_key=1234567890abcdef</span>
955
+
956
+ <span class="p">[</span>
957
+ <span class="p">{</span>
958
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-04-24T02:12:09Z"</span><span class="p">,</span>
959
+ <span class="s2">"end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
960
+ <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
961
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">831330</span><span class="p">,</span>
962
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7794</span><span class="p">,</span>
963
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.418</span><span class="p">,</span>
964
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Philadelphia Orchestra @ Davies Symphony Hall"</span><span class="p">,</span>
965
+ <span class="s2">"num_cancelled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
966
+ <span class="s2">"num_confirmed_bookings"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
967
+ <span class="s2">"num_disabled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
968
+ <span class="s2">"num_unconfirmed_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
969
+ <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
970
+ <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
971
+ <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2012-06-11T06:59:00Z"</span><span class="p">,</span>
972
+ <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
973
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T03:51:22Z"</span><span class="p">,</span>
974
+ <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">51886</span><span class="p">,</span>
975
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/831330"</span>
976
+ <span class="p">},</span>
977
+ <span class="p">{</span>
978
+ <span class="p">...</span>
979
+ <span class="p">},</span>
980
+ <span class="p">...</span>
981
+ <span class="p">]</span>
982
+ </pre>
983
+ </div>
984
+
985
+
986
+ <h2>Person</h2>
987
+
988
+ <p>Fields:</p>
989
+
990
+ <ul>
991
+ <li>
992
+ <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
993
+ <li>
994
+ <strong>first_name</strong> <em>string</em> First name of the Person</li>
995
+ <li>
996
+ <strong>gender</strong> <em>string</em> Gender of the Person</li>
997
+ <li>
998
+ <strong>id</strong> <em>integer</em> Thrillcall ID</li>
999
+ <li>
1000
+ <strong>last_name</strong> <em>string</em> Last name of the Person</li>
1001
+ <li>
1002
+ <strong>login</strong> <em>string</em> Login of the Person</li>
1003
+ <li>
1004
+ <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
1005
+ <li>
1006
+ <strong>referral_code</strong> <em>string</em> Referral code of the Person</li>
1007
+ <li>
1008
+ <strong>referral_code_count</strong> <em>integer</em> Number of Referral code used for the Person</li>
1009
+ <li>
1010
+ <strong>postalcode</strong> <em>string</em> Postalcode of the Person</li>
1011
+ <li>
1012
+ <strong>postalcode</strong> <em>string</em> Postalcode of the Person</li>
1013
+ </ul><h3>POST /person/signin</h3>
1014
+
1015
+ <p>Params:</p>
1016
+
1017
+ <ul>
1018
+ <li><strong><a href="#login">login</a></strong></li>
1019
+ <li><strong><a href="#password">password</a></strong></li>
1020
+ </ul><p>Returns: Person <em>Hash</em></p>
1021
+
1022
+ <div class="highlight">
1023
+ <pre> <span class="c1">// Example: POST /api/v2/person/signin</span>
1024
+
1025
+ <span class="p">{</span>
1026
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2000-11-09T19:09:23Z"</span><span class="p">,</span>
1027
+ <span class="s2">"first_name"</span><span class="o">:</span> <span class="s2">"John"</span><span class="p">,</span>
1028
+ <span class="s2">"gender"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1029
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">49</span><span class="p">,</span>
1030
+ <span class="s2">"last_name"</span><span class="o">:</span> <span class="s2">"Doe"</span><span class="p">,</span>
1031
+ <span class="s2">"login"</span><span class="o">:</span> <span class="s2">"john@example.com"</span><span class="p">,</span>
1032
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-11-09T19:09:23Z"</span><span class="p">,</span>
1033
+ <span class="s2">"referral_code"</span><span class="o">:</span> <span class="s2">"fhskjfhk3j43h43hjkh"</span><span class="p">,</span>
1034
+ <span class="s2">"referral_code_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1035
+ <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94104"</span>
1036
+ <span class="p">}</span>
1037
+ </pre>
1038
+ </div>
1039
+
1040
+
1041
+ <h3>POST /person/signup</h3>
1042
+
1043
+ <p>Params:</p>
1044
+
1045
+ <ul>
1046
+ <li><strong><a href="#first_name">first_name</a></strong></li>
1047
+ <li><strong><a href="#last_name">last_name</a></strong></li>
1048
+ <li><strong><a href="#gender">gender</a></strong></li>
1049
+ <li><strong><a href="#email">email</a></strong></li>
1050
+ <li><strong><a href="#password">password</a></strong></li>
1051
+ <li><strong><a href="#postalcode">postalcode</a></strong></li>
1052
+ </ul><p>Returns: Person <em>Hash</em></p>
1053
+
1054
+ <div class="highlight">
1055
+ <pre> <span class="c1">// Example: POST /api/v2/person/signup</span>
1056
+
1057
+ <span class="p">{</span>
1058
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2000-11-09T19:09:23Z"</span><span class="p">,</span>
1059
+ <span class="s2">"first_name"</span><span class="o">:</span> <span class="s2">"John"</span><span class="p">,</span>
1060
+ <span class="s2">"gender"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1061
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">49</span><span class="p">,</span>
1062
+ <span class="s2">"last_name"</span><span class="o">:</span> <span class="s2">"Doe"</span><span class="p">,</span>
1063
+ <span class="s2">"login"</span><span class="o">:</span> <span class="s2">"john@example.com"</span><span class="p">,</span>
1064
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-11-09T19:09:23Z"</span><span class="p">,</span>
1065
+ <span class="s2">"referral_code"</span><span class="o">:</span> <span class="s2">"fhskjfhk3j43h43hjkh"</span><span class="p">,</span>
1066
+ <span class="s2">"referral_code_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1067
+ <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94104"</span>
1068
+ <span class="p">}</span>
1069
+ </pre>
1070
+ </div>
1071
+
1072
+
1073
+ <h2>Venues</h2>
1074
+
1075
+ <p>Fields:</p>
1076
+
1077
+ <ul>
1078
+ <li>
1079
+ <strong>address1</strong> <em>string</em> First address field for the Venue</li>
1080
+ <li>
1081
+ <strong>address2</strong> <em>string</em> Second address field for the Venue</li>
1082
+ <li>
1083
+ <strong>city</strong> <em>string</em> City the Venue is in</li>
1084
+ <li>
1085
+ <strong>country</strong> <em>string</em> Country the Venue is in</li>
1086
+ <li>
1087
+ <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
1088
+ <li>
1089
+ <strong>id</strong> <em>integer</em> Thrillcall ID</li>
1090
+ <li>
1091
+ <strong>latitude</strong> <em>float</em> Approximate Latitude for the Venue</li>
1092
+ <li>
1093
+ <strong>longitude</strong> <em>float</em> Approximate Longitude for the Venue</li>
1094
+ <li>
1095
+ <strong>name</strong> <em>string</em> Name of the Venue</li>
1096
+ <li>
1097
+ <strong>metro_area_id</strong> <em>integer</em> Thrillcall ID of the Metro Area this Venue is in, if any</li>
1098
+ <li>
1099
+ <strong>state</strong> <em>string</em> State the Venue is in</li>
1100
+ <li>
1101
+ <strong>upcoming_events_count</strong> <em>integer</em> Number of upcoming events associated with this object</li>
1102
+ <li>
1103
+ <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
1104
+ <li>
1105
+ <strong>postalcode</strong> <em>string</em> Postal code for the Venue</li>
1106
+ <li>
1107
+ <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
1108
+ </ul><h3>GET /venues</h3>
1109
+
1110
+ <p>Params:</p>
1111
+
1112
+ <ul>
1113
+ <li><strong><a href="#limit">limit</a></strong></li>
1114
+ <li><strong><a href="#page">page</a></strong></li>
1115
+ <li><strong><a href="#lat">lat</a></strong></li>
1116
+ <li><strong><a href="#long">long</a></strong></li>
1117
+ <li><strong><a href="#postalcode">postalcode</a></strong></li>
1118
+ <li><strong><a href="#radius">radius</a></strong></li>
1119
+ </ul><p>Returns: <em>Array</em> of Venues <em>Hash</em></p>
1120
+
1121
+ <div class="highlight">
1122
+ <pre> <span class="c1">// Example: GET /api/v2/venues?limit=14&amp;api_key=1234567890abcdef</span>
1123
+
1124
+ <span class="p">[</span>
1125
+ <span class="p">{</span>
1126
+ <span class="s2">"address1"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1127
+ <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1128
+ <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"Guadalajara"</span><span class="p">,</span>
1129
+ <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"MX"</span><span class="p">,</span>
1130
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2000-11-09T19:09:23Z"</span><span class="p">,</span>
1131
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
1132
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1133
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1134
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Fbolko"</span><span class="p">,</span>
1135
+ <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"MX"</span><span class="p">,</span>
1136
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1137
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-28T17:24:20Z"</span><span class="p">,</span>
1138
+ <span class="s2">"postalcode"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1139
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Fbolko_in_Guadalajara_MX"</span>
1140
+ <span class="p">},</span>
1141
+ <span class="p">{</span>
1142
+ <span class="p">...</span>
1143
+ <span class="p">},</span>
1144
+ <span class="p">...</span>
1145
+ <span class="p">]</span>
1146
+ </pre>
1147
+ </div>
1148
+
1149
+
1150
+ <h3>GET /venue/:id</h3>
1151
+
1152
+ <p><strong>:id</strong> <em>integer</em> Thrillcall or Partner ID</p>
1153
+
1154
+ <p>Params:</p>
1155
+
1156
+ <ul>
1157
+ <li><strong><a href="#use_partner_id">use_partner_id</a></strong></li>
1158
+ </ul><p>Returns: Venue <em>Hash</em></p>
1159
+
1160
+ <div class="highlight">
1161
+ <pre> <span class="c1">// Example: GET /api/v2/venue/27418?api_key=1234567890abcdef</span>
1162
+
1163
+ <span class="p">{</span>
1164
+ <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"859 O'Farrell St."</span><span class="p">,</span>
1165
+ <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1166
+ <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
1167
+ <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
1168
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-21T16:52:31Z"</span><span class="p">,</span>
1169
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
1170
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.784796</span><span class="p">,</span>
1171
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.418819</span><span class="p">,</span>
1172
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Great American Music Hall"</span><span class="p">,</span>
1173
+ <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
1174
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">34</span><span class="p">,</span>
1175
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-20T21:04:37Z"</span><span class="p">,</span>
1176
+ <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94109"</span><span class="p">,</span>
1177
+ <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
1178
+ <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>
1179
+ <span class="p">}</span>
1180
+ </pre>
1181
+ </div>
1182
+
1183
+
1184
+ <h3>GET /venue/:id/events</h3>
1185
+
1186
+ <p><strong>:id</strong> <em>integer</em> Thrillcall or Partner ID</p>
1187
+
1188
+ <p>Params:</p>
1189
+
1190
+ <ul>
1191
+ <li><strong><a href="#limit">limit</a></strong></li>
1192
+ <li><strong><a href="#page">page</a></strong></li>
1193
+ <li><strong><a href="#min_date">min_date</a></strong></li>
1194
+ <li><strong><a href="#max_date">max_date</a></strong></li>
1195
+ <li><strong><a href="#use_partner_id">use_partner_id</a></strong></li>
1196
+ <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
1197
+ <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
1198
+ <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
1199
+ <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
1200
+ </ul><p>Returns: <em>Array</em> of Events <em>Hash</em></p>
1201
+
1202
+ <div class="highlight">
1203
+ <pre> <span class="c1">// Example: GET /api/v2/venue/32065/events?api_key=1234567890abcdef</span>
1204
+
1205
+ <span class="p">[</span>
1206
+ <span class="p">{</span>
1207
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2000-11-09T19:09:23Z"</span><span class="p">,</span>
1208
+ <span class="s2">"end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1209
+ <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
1210
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">824614</span><span class="p">,</span>
1211
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.8016</span><span class="p">,</span>
1212
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">80.4462</span><span class="p">,</span>
1213
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Colt Ford @ West Virginia State Fair"</span><span class="p">,</span>
1214
+ <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1215
+ <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
1216
+ <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2011-08-21T03:59:00Z"</span><span class="p">,</span>
1217
+ <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1218
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-06-24T05:10:05Z"</span><span class="p">,</span>
1219
+ <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">32065</span><span class="p">,</span>
1220
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/824614"</span>
1221
+ <span class="p">},</span>
1222
+ <span class="p">{</span>
1223
+ <span class="p">...</span>
1224
+ <span class="p">},</span>
1225
+ <span class="p">...</span>
1226
+ <span class="p">]</span>
1227
+ </pre>
1228
+ </div>
1229
+
1230
+
1231
+ <h3>GET /search/venues/:term</h3>
1232
+
1233
+ <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>
1234
+
1235
+ <p>Params:</p>
1236
+
1237
+ <ul>
1238
+ <li><strong><a href="#limit">limit</a></strong></li>
1239
+ <li><strong><a href="#page">page</a></strong></li>
1240
+ <li><strong><a href="#lat">lat</a></strong></li>
1241
+ <li><strong><a href="#long">long</a></strong></li>
1242
+ <li><strong><a href="#postalcode">postalcode</a></strong></li>
1243
+ <li><strong><a href="#radius">radius</a></strong></li>
1244
+ </ul><p>Returns: <em>Array</em> of Venues <em>Hash</em></p>
1245
+
1246
+ <div class="highlight">
1247
+ <pre> <span class="c1">// Example: GET /api/v2/search/venues/Great%20American%20Music%20Hall?api_key=1234567890abcdef</span>
1248
+
1249
+ <span class="p">[</span>
1250
+ <span class="p">{</span>
1251
+ <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"859 O'Farrell St."</span><span class="p">,</span>
1252
+ <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1253
+ <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
1254
+ <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
1255
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-21T16:52:31Z"</span><span class="p">,</span>
1256
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
1257
+ <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.784796</span><span class="p">,</span>
1258
+ <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.418819</span><span class="p">,</span>
1259
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Great American Music Hall"</span><span class="p">,</span>
1260
+ <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
1261
+ <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">34</span><span class="p">,</span>
1262
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-20T21:04:37Z"</span><span class="p">,</span>
1263
+ <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94109"</span><span class="p">,</span>
1264
+ <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
1265
+ <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>
1266
+ <span class="p">},</span>
1267
+ <span class="p">{</span>
1268
+ <span class="p">...</span>
1269
+ <span class="p">},</span>
1270
+ <span class="p">...</span>
1271
+ <span class="p">]</span>
1272
+ </pre>
1273
+ </div>
1274
+
1275
+
1276
+ <h2>Tickets</h2>
1277
+
1278
+ <p>Fields:</p>
1279
+
1280
+ <ul>
1281
+ <li>
1282
+ <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
1283
+ <li>
1284
+ <strong>description</strong> <em>string</em> Long form description of the ticket</li>
1285
+ <li>
1286
+ <strong>event_id</strong> <em>integer</em> Thrillcall Event ID</li>
1287
+ <li>
1288
+ <strong>id</strong> <em>integer</em> Thrillcall ID</li>
1289
+ <li>
1290
+ <strong>marketing_text</strong> <em>string</em> Long form description of the ticket</li>
1291
+ <li>
1292
+ <strong>max_ticket_price</strong> <em>float</em> Maximum price for this ticket</li>
1293
+ <li>
1294
+ <strong>min_ticket_price</strong> <em>float</em> Minimum price for this ticket</li>
1295
+ <li>
1296
+ <strong>name</strong> <em>string</em> Name of this ticket</li>
1297
+ <li>
1298
+ <strong>on_sale_end_date</strong> <em>string</em> YYYY-MM-DD date when the ticket goes off sale</li>
1299
+ <li>
1300
+ <strong>on_sale_start_date</strong> <em>string</em> YYYY-MM-DD date when the ticket goes on sale</li>
1301
+ <li>
1302
+ <strong>seat_info</strong> <em>string</em> Additional info about the seat</li>
1303
+ <li>
1304
+ <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
1305
+ <li>
1306
+ <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
1307
+ </ul><h3>GET /tickets</h3>
1308
+
1309
+ <p>Params:</p>
1310
+
1311
+ <ul>
1312
+ <li><strong><a href="#limit">limit</a></strong></li>
1313
+ <li><strong><a href="#page">page</a></strong></li>
1314
+ <li><strong><a href="#min_date">min_date</a></strong></li>
1315
+ <li><strong><a href="#max_date">max_date</a></strong></li>
1316
+ <li><strong><a href="#lat">lat</a></strong></li>
1317
+ <li><strong><a href="#long">long</a></strong></li>
1318
+ <li><strong><a href="#postalcode">postalcode</a></strong></li>
1319
+ <li><strong><a href="#radius">radius</a></strong></li>
1320
+ <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
1321
+ <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
1322
+ <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
1323
+ </ul><p>Returns: <em>Array</em> of Tickets <em>Hash</em></p>
1324
+
1325
+ <div class="highlight">
1326
+ <pre> <span class="c1">// Example: GET /api/v2/tickets?limit=14&amp;api_key=1234567890abcdef</span>
1327
+
1328
+ <span class="p">[</span>
1329
+ <span class="p">{</span>
1330
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-12-06T00:19:59Z"</span><span class="p">,</span>
1331
+ <span class="s2">"description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1332
+ <span class="s2">"event_id"</span><span class="o">:</span> <span class="mi">455646</span><span class="p">,</span>
1333
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
1334
+ <span class="s2">"marketing_text"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1335
+ <span class="s2">"max_ticket_price"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1336
+ <span class="s2">"min_ticket_price"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1337
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"General Onsale"</span><span class="p">,</span>
1338
+ <span class="s2">"on_sale_end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1339
+ <span class="s2">"on_sale_start_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1340
+ <span class="s2">"seat_info"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1341
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2009-09-22T22:58:37Z"</span><span class="p">,</span>
1342
+ <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://www.livenation.com/edp/eventId/335800/?c=api-000157"</span>
1343
+ <span class="p">},</span>
1344
+ <span class="p">{</span>
1345
+ <span class="p">...</span>
1346
+ <span class="p">},</span>
1347
+ <span class="p">...</span>
1348
+ <span class="p">]</span>
1349
+ </pre>
1350
+ </div>
1351
+
1352
+
1353
+ <h3>GET /ticket/:id</h3>
1354
+
1355
+ <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
1356
+
1357
+ <p>Params:</p>
1358
+
1359
+ <ul>
1360
+ <li>None</li>
1361
+ </ul><p>Returns: Ticket <em>Hash</em></p>
1362
+
1363
+ <div class="highlight">
1364
+ <pre> <span class="c1">// Example: GET /api/v2/ticket/599794?api_key=1234567890abcdef</span>
1365
+
1366
+ <span class="p">{</span>
1367
+ <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:16Z"</span><span class="p">,</span>
1368
+ <span class="s2">"description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1369
+ <span class="s2">"event_id"</span><span class="o">:</span> <span class="mi">858707</span><span class="p">,</span>
1370
+ <span class="s2">"id"</span><span class="o">:</span> <span class="mi">599794</span><span class="p">,</span>
1371
+ <span class="s2">"marketing_text"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1372
+ <span class="s2">"max_ticket_price"</span><span class="o">:</span> <span class="mi">21</span><span class="p">,</span>
1373
+ <span class="s2">"min_ticket_price"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1374
+ <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Gen. Admission Seating Limited"</span><span class="p">,</span>
1375
+ <span class="s2">"on_sale_end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1376
+ <span class="s2">"on_sale_start_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1377
+ <span class="s2">"seat_info"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1378
+ <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:16Z"</span><span class="p">,</span>
1379
+ <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>
1380
+ <span class="p">}</span>
1381
+ </pre>
1382
+ </div>