RubyGems - thrillcall-api - Versions diffs - 0.0.4 → 0.0.6 - Mend

thrillcall-api 0.0.4 → 0.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

data/Gemfile.lock +18 -12
data/README.md +429 -334
data/docs/API.html +439 -336
data/docs/API.md +426 -331
data/docs/README.html +442 -339
data/docs/WRAPPER.html +3 -3
data/docs/WRAPPER.md +3 -3
data/lib/thrillcall-api.rb +9 -3
data/lib/thrillcall-api/version.rb +1 -1
data/spec/thrillcall-api/thrillcall-api_spec.rb +116 -8
data/thrillcall-api.gemspec +3 -1
metadata +120 -28

data/docs/README.html CHANGED Viewed

@@ -64,7 +64,7 @@
 .highlight .il { color: #666666 } /* Literal.Number.Integer.Long */
 </style><h1>Thrillcall API</h1>
-<p>This document describes the Thrillcall API v2, and usage for the provided Ruby API wrapper gem.</p>
+<p>This document describes the Thrillcall API v3, and usage for the provided Ruby API wrapper gem.</p>
 <h1>Ruby API Wrapper</h1>
@@ -123,7 +123,7 @@
 <div class="highlight">
 <pre>    <span class="c1">#---------------------------------------------------------------#</span>
     <span class="c1"># The default SSL endpoint is "https://api.thrillcall.com/api/".</span>
-    <span class="c1"># The default API version is 2.</span>
+    <span class="c1"># The default API version is 3.</span>
     <span class="c1"># By default, Faraday access logging is turned off.</span>
     <span class="c1"># Override if necessary:</span>
     <span class="c1">#---------------------------------------------------------------#</span>
@@ -161,7 +161,7 @@
     <span class="nb">require</span> <span class="s1">'json'</span>
     <span class="no">MY_API_KEY</span>  <span class="o">=</span> <span class="s2">"1234567890abcdef"</span>
-    <span class="no">BASE_URL</span>    <span class="o">=</span> <span class="s2">"https://api.thrillcall.com/api/v2/"</span>
+    <span class="no">BASE_URL</span>    <span class="o">=</span> <span class="s2">"https://api.thrillcall.com/api/v3/"</span>
     <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>
     <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>
@@ -206,7 +206,7 @@ Access over an insecure HTTP (port 80) endpoint is now deprecated and will be di
 <p><em>Default: 100</em></p>
-<p>Sets the maximum number of results to return.  Cannot be above 100.</p>
+<p>Sets the maximum number of results to return.  Cannot be above 200.</p>
 </li>
 <li>
 <p><a name="page"></a><strong>page</strong> <em>integer</em></p>
@@ -218,6 +218,14 @@ Access over an insecure HTTP (port 80) endpoint is now deprecated and will be di
 <p>Specifies the page number.  If limit is 10, then page = 2 will return results #20 through #29</p>
 </li>
 <li>
+<p><a name="time_zone"></a><strong>time_zone</strong> <em>string (format: TZ Database string, eg "America/Los</em>Angeles")_</p>
+<p><em>Default: UTC</em>
+<em>For Metro Area endpoints, the default is instead the Metro Area's time zone and cannot be overridden.</em></p>
+<p><strong><a href="#min_date">min_date</a></strong> and <strong><a href="#max_date">max_date</a></strong> will be calculated based on this time zone.</p>
+</li>
+<li>
 <p><a name="min_date"></a><strong>min_date</strong> <em>string (format: "YYYY-MM-DD")</em></p>
 <p><em>Default: Today</em></p>
@@ -232,6 +240,20 @@ Access over an insecure HTTP (port 80) endpoint is now deprecated and will be di
 <p>Results after this date will not be returned.</p>
 </li>
 <li>
+<p><a name="min_updated_at"></a><strong>min_updated_at</strong> <em>string (format: "YYYY-MM-DD")</em></p>
+<p><em>Default: none</em></p>
+<p>Results with updated_at columns before this date will not be returned.</p>
+</li>
+<li>
+<p><a name="max_date"></a><strong>max_updated_at</strong> <em>string (format: "YYYY-MM-DD")</em></p>
+<p><em>Default: none</em></p>
+<p>Results with updated_at columns after this date will not be returned.</p>
+</li>
+<li>
 <p><a name="lat"></a><strong>lat</strong> <em>float</em></p>
 <p><em>Default: none</em></p>
@@ -288,6 +310,13 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 <p>If set to <em>true</em> or <em>1</em>, will only return results that have tickets associated with them.</p>
 </li>
 <li>
+<p><a name="show_disabled_events"></a><strong>show_disabled_events</strong> <em>boolean</em></p>
+<p><em>Default: false</em></p>
+<p>If set to <em>true</em> or <em>1</em>, will not filter out events which have been disabled internally.</p>
+</li>
+<li>
 <p><a name="show_unconfirmed_events"></a><strong>show_unconfirmed_events</strong> <em>boolean</em></p>
 <p><em>Default: false</em></p>
@@ -356,7 +385,7 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 <li>
 <p><a name="referral_code"></a><strong>referral_code</strong> <em>string</em></p>
-<p>The referral code to be used during registration.  Both the owner of the code as well as the new user will receive a point on their referral counts.</p>
+<p>The referral code to be used during registration.  Both the owner of the code as well as the new user will receive a referral credit point.</p>
 </li>
 </ul><h2>Artists</h2>
@@ -392,7 +421,7 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns:  <em>Array</em> of Artists <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/artists?limit=14&amp;api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/artists?limit=14&amp;api_key=1234567890abcdef</span>
     <span class="p">[</span>
       <span class="p">{</span>
@@ -403,13 +432,12 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
         <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">61</span><span class="p">,</span>
         <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
         <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-26T16:49:20Z"</span><span class="p">,</span>
-        <span class="s2">"photos"</span><span class="o">:</span>
-            <span class="p">{</span>
-              <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-              <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-medium.jpg"</span><span class="p">,</span>
-              <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-large.jpg"</span><span class="p">,</span>
-              <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-mobile.jpg"</span>
-            <span class="p">},</span>
+        <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+          <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-thumbnail.jpg"</span><span class="p">,</span>
+          <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-medium.jpg"</span><span class="p">,</span>
+          <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-large.jpg"</span><span class="p">,</span>
+          <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-mobile.jpg"</span>
+        <span class="p">},</span>
         <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Hyler_Jones_Proteges"</span>
       <span class="p">},</span>
       <span class="p">{</span>
@@ -432,24 +460,23 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns:  Artist <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/artist/4802?api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/artist/378465?api_key=1234567890abcdef</span>
     <span class="p">{</span>
-      <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-28T18:56:09Z"</span><span class="p">,</span>
-      <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Rock"</span><span class="p">,</span>
-      <span class="s2">"id"</span><span class="o">:</span> <span class="mi">4802</span><span class="p">,</span>
-      <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"The Sea and Cake"</span><span class="p">,</span>
-      <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
-      <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">8</span><span class="p">,</span>
-      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-20T19:12:57Z"</span><span class="p">,</span>
-      <span class="s2">"photos"</span><span class="o">:</span>
-            <span class="p">{</span>
-              <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-              <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-medium.jpg"</span><span class="p">,</span>
-              <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-large.jpg"</span><span class="p">,</span>
-              <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-mobile.jpg"</span>
-            <span class="p">},</span>
-      <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/The_Sea_and_Cake"</span>
+      <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-05-19T20:27:47Z"</span><span class="p">,</span>
+      <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Operatic pop"</span><span class="p">,</span>
+      <span class="s2">"id"</span><span class="o">:</span> <span class="mi">378465</span><span class="p">,</span>
+      <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Il Volo"</span><span class="p">,</span>
+      <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">61</span><span class="p">,</span>
+      <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">30</span><span class="p">,</span>
+      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-27T15:59:04Z"</span><span class="p">,</span>
+      <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+        <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426"</span><span class="p">,</span>
+        <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426"</span><span class="p">,</span>
+        <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426"</span><span class="p">,</span>
+        <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"</span>
+      <span class="p">},</span>
+      <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Il_Volo"</span>
     <span class="p">}</span>
 </pre>
 </div>
@@ -464,8 +491,11 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 <ul>
 <li><strong><a href="#limit">limit</a></strong></li>
 <li><strong><a href="#page">page</a></strong></li>
+<li><strong><a href="#time_zone">time_zone</a></strong></li>
 <li><strong><a href="#min_date">min_date</a></strong></li>
 <li><strong><a href="#max_date">max_date</a></strong></li>
+<li><strong><a href="#min_updated_at">min_updated_at</a></strong></li>
+<li><strong><a href="#max_updated_at">max_updated_at</a></strong></li>
 <li><strong><a href="#lat">lat</a></strong></li>
 <li><strong><a href="#long">long</a></strong></li>
 <li><strong><a href="#postalcode">postalcode</a></strong></li>
@@ -473,39 +503,39 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 <li><strong><a href="#use_partner_id">use_partner_id</a></strong></li>
 <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
 <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
+<li><strong><a href="#show_disabled_events">show_disabled_events</a></strong></li>
 <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
 <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
 </ul><p>Returns:  <em>Array</em> of Events <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/artist/4802/events?api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/artist/378465/events?api_key=1234567890abcdef</span>
     <span class="p">[</span>
       <span class="p">{</span>
-        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-23T23:10:31Z"</span><span class="p">,</span>
-        <span class="s2">"end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2012-03-02T08:01:03Z"</span><span class="p">,</span>
         <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
-        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">862618</span><span class="p">,</span>
-        <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">30.2729</span><span class="p">,</span>
-        <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">97.7405</span><span class="p">,</span>
-        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"The Sea and Cake @ The Mohawk"</span><span class="p">,</span>
-        <span class="s2">"num_cancelled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-        <span class="s2">"num_confirmed_bookings"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
-        <span class="s2">"num_disabled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-        <span class="s2">"num_unconfirmed_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
+        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1046915</span><span class="p">,</span>
+        <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">47.6136</span><span class="p">,</span>
+        <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.332</span><span class="p">,</span>
+        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Il Volo @ Paramount Theatre - Seattle"</span><span class="p">,</span>
         <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
         <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
-        <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2011-12-09T05:59:00Z"</span><span class="p">,</span>
+        <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2012-10-02T19:30:00Z"</span><span class="p">,</span>
+        <span class="s2">"starts_at"</span><span class="o">:</span> <span class="s2">"2012-10-03T02:30:00Z"</span><span class="p">,</span>
+        <span class="s2">"starts_at_time_trusted"</span><span class="o">:</span> <span class="kc">true</span><span class="p">,</span>
         <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T04:01:56Z"</span><span class="p">,</span>
-        <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">10116</span><span class="p">,</span>
-        <span class="s2">"photos"</span><span class="o">:</span>
-            <span class="p">{</span>
-              <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-              <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-large.jpg"</span><span class="p">,</span>
-              <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-mobile.jpg"</span>
-            <span class="p">},</span>
-        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/862618"</span>
+        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-29T01:35:53Z"</span><span class="p">,</span>
+        <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">61705</span><span class="p">,</span>
+        <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+          <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426"</span><span class="p">,</span>
+          <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426"</span><span class="p">,</span>
+          <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"</span>
+        <span class="p">},</span>
+        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/1046915"</span><span class="p">,</span>
+        <span class="s2">"starts_at_local"</span><span class="o">:</span> <span class="s2">"2012-10-02T19:30:00-07:00"</span><span class="p">,</span>
+        <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span><span class="p">,</span>
+        <span class="s2">"status"</span><span class="o">:</span> <span class="s2">"confirmed"</span>
       <span class="p">},</span>
       <span class="p">{</span>
         <span class="p">...</span>
@@ -528,25 +558,24 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns:  <em>Array</em> of Artists <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/search/artists/The%20Sea%20and%20Cake?api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/search/artists/Il%20Volo?api_key=1234567890abcdef</span>
     <span class="p">[</span>
       <span class="p">{</span>
-        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-28T18:56:09Z"</span><span class="p">,</span>
-        <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Rock"</span><span class="p">,</span>
-        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">4802</span><span class="p">,</span>
-        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"The Sea and Cake"</span><span class="p">,</span>
-        <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
-        <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">8</span><span class="p">,</span>
-        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-20T19:12:57Z"</span><span class="p">,</span>
-        <span class="s2">"photos"</span><span class="o">:</span>
-            <span class="p">{</span>
-              <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-              <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-medium.jpg"</span><span class="p">,</span>
-              <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-large.jpg"</span><span class="p">,</span>
-              <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-mobile.jpg"</span>
-            <span class="p">},</span>
-        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/The_Sea_and_Cake"</span>
+        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-05-19T20:27:47Z"</span><span class="p">,</span>
+        <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Operatic pop"</span><span class="p">,</span>
+        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">378465</span><span class="p">,</span>
+        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Il Volo"</span><span class="p">,</span>
+        <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">61</span><span class="p">,</span>
+        <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">30</span><span class="p">,</span>
+        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-27T15:59:04Z"</span><span class="p">,</span>
+        <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+          <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426"</span><span class="p">,</span>
+          <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426"</span><span class="p">,</span>
+          <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426"</span><span class="p">,</span>
+          <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"</span>
+        <span class="p">},</span>
+        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Il_Volo"</span>
       <span class="p">},</span>
       <span class="p">{</span>
         <span class="p">...</span>
@@ -565,8 +594,6 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 <li>
 <strong>created_at</strong>                 <em>string</em>  ISO 8601 representation the time this object was created</li>
 <li>
-<strong>end_date</strong>                   <em>string</em>  ISO 8601 representation of the end of the Event</li>
-<li>
 <strong>festival</strong>                    <em>boolean</em> Is this event a festival?</li>
 <li>
 <strong>id</strong>                          <em>integer</em> Thrillcall ID</li>
@@ -577,21 +604,21 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 <li>
 <strong>name</strong>                        <em>string</em>  Name of the Event</li>
 <li>
-<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>
+<strong>on_sale_date</strong>              <em>string</em>  ISO 8601 representation of the date when tickets go on sale</li>
 <li>
-<strong>num_unconfirmed_bookings</strong>  <em>integer</em> The number of unconfirmed Artist bookings for this event</li>
+<strong>rumor</strong>                       <em>boolean</em> Are the details for this event based on a rumor?</li>
 <li>
-<strong>num_disabled_bookings</strong>     <em>integer</em> The number of disabled Artist bookings for this event</li>
+<strong>status</strong>                      <em>string</em>  Status of the event (confirmed, unconfirmed, cancelled, or disabled)</li>
 <li>
-<strong>num_cancelled_bookings</strong>    <em>integer</em> The number of cancelled Artist bookings for this event</li>
+<strong>starts_at</strong>                  <em>string</em>  ISO 8601 representation of the start of the Event in UTC time</li>
 <li>
-<strong>on_sale_date</strong>              <em>string</em>  ISO 8601 representation of the date when tickets go on sale</li>
+<strong>starts_at_local</strong>           <em>string</em>  ISO 8601 representation of the start of the Event in the local timezone</li>
 <li>
-<strong>rumor</strong>                       <em>boolean</em> Are the details for this event based on a rumor?</li>
+<strong>starts_at_time_trusted</strong>   <em>boolean</em> Do we trust that the time of day component of <strong>starts_at</strong> is valid?</li>
 <li>
-<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>
+<strong>time_zone</strong>                  <em>string</em>  TZ Database string representing the time zone at the location of the event</li>
 <li>
-<strong>unconfirmed_location</strong>       <em>integer</em> If 1, the location if this event is unconfirmed</li>
+<strong>unconfirmed_location</strong>       <em>integer</em> If 1, the location of this event is unconfirmed</li>
 <li>
 <strong>updated_at</strong>                 <em>string</em>  ISO 8601 representation of last time this object was updated</li>
 <li>
@@ -607,47 +634,50 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 <ul>
 <li><strong><a href="#limit">limit</a></strong></li>
 <li><strong><a href="#page">page</a></strong></li>
+<li><strong><a href="#time_zone">time_zone</a></strong></li>
 <li><strong><a href="#min_date">min_date</a></strong></li>
 <li><strong><a href="#max_date">max_date</a></strong></li>
+<li><strong><a href="#min_updated_at">min_updated_at</a></strong></li>
+<li><strong><a href="#max_updated_at">max_updated_at</a></strong></li>
 <li><strong><a href="#lat">lat</a></strong></li>
 <li><strong><a href="#long">long</a></strong></li>
 <li><strong><a href="#postalcode">postalcode</a></strong></li>
 <li><strong><a href="#radius">radius</a></strong></li>
 <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
 <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
+<li><strong><a href="#show_disabled_events">show_disabled_events</a></strong></li>
 <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
 <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
 </ul><p>Returns:  <em>Array</em> of Events <em>Hash</em></p>
 <div class="highlight">
-<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>
+<pre>    <span class="c1">// Example: GET /api/v3/events?must_have_tickets=true&amp;postalcode=94108&amp;radius=10&amp;limit=3&amp;api_key=1234567890abcdef</span>
     <span class="p">[</span>
       <span class="p">{</span>
-        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:13Z"</span><span class="p">,</span>
-        <span class="s2">"end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2012-03-02T18:06:14Z"</span><span class="p">,</span>
         <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
-        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">858707</span><span class="p">,</span>
-        <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7951</span><span class="p">,</span>
-        <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.421</span><span class="p">,</span>
-        <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>
-        <span class="s2">"num_cancelled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-        <span class="s2">"num_confirmed_bookings"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
-        <span class="s2">"num_disabled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-        <span class="s2">"num_unconfirmed_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
+        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1047075</span><span class="p">,</span>
+        <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7915</span><span class="p">,</span>
+        <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.413</span><span class="p">,</span>
+        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Il Volo @ Masonic Center"</span><span class="p">,</span>
         <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
         <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
-        <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2011-12-06T07:59:00Z"</span><span class="p">,</span>
+        <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2012-09-29T19:30:04Z"</span><span class="p">,</span>
+        <span class="s2">"starts_at"</span><span class="o">:</span> <span class="s2">"2012-09-30T02:30:04Z"</span><span class="p">,</span>
+        <span class="s2">"starts_at_time_trusted"</span><span class="o">:</span> <span class="kc">true</span><span class="p">,</span>
         <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T04:00:41Z"</span><span class="p">,</span>
-        <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
-        <span class="s2">"photos"</span><span class="o">:</span>
-            <span class="p">{</span>
-              <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-              <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-large.jpg"</span><span class="p">,</span>
-              <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-mobile.jpg"</span>
-            <span class="p">},</span>
-        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/858707"</span>
+        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-29T01:35:57Z"</span><span class="p">,</span>
+        <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">63279</span><span class="p">,</span>
+        <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+          <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426"</span><span class="p">,</span>
+          <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426"</span><span class="p">,</span>
+          <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"</span>
+        <span class="p">},</span>
+        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/1047075"</span><span class="p">,</span>
+        <span class="s2">"starts_at_local"</span><span class="o">:</span> <span class="s2">"2012-09-29T19:30:04-07:00"</span><span class="p">,</span>
+        <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span>
+        <span class="s2">"status"</span><span class="o">:</span> <span class="s2">"confirmed"</span>
       <span class="p">},</span>
       <span class="p">{</span>
         <span class="p">...</span>
@@ -669,33 +699,33 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns:  Event <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/event/858707?api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/event/1045602/venue?api_key=1234567890abcdef</span>
     <span class="p">{</span>
-      <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:13Z"</span><span class="p">,</span>
-      <span class="s2">"end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
-      <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
-      <span class="s2">"id"</span><span class="o">:</span> <span class="mi">858707</span><span class="p">,</span>
-      <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7951</span><span class="p">,</span>
-      <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.421</span><span class="p">,</span>
-      <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>
-      <span class="s2">"num_cancelled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-      <span class="s2">"num_confirmed_bookings"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
-      <span class="s2">"num_disabled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-      <span class="s2">"num_unconfirmed_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-      <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
-      <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
-      <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2011-12-06T07:59:00Z"</span><span class="p">,</span>
-      <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T04:00:41Z"</span><span class="p">,</span>
-      <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
-      <span class="s2">"photos"</span><span class="o">:</span>
-            <span class="p">{</span>
-              <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-              <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-large.jpg"</span><span class="p">,</span>
-              <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-mobile.jpg"</span>
-            <span class="p">},</span>
-      <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/858707"</span>
+      <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"1111 California Street"</span><span class="p">,</span>
+      <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
+      <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
+      <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2009-08-25T19:25:27Z"</span><span class="p">,</span>
+      <span class="s2">"id"</span><span class="o">:</span> <span class="mi">63279</span><span class="p">,</span>
+      <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.79153</span><span class="p">,</span>
+      <span class="s2">"long_description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.412757</span><span class="p">,</span>
+      <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Masonic Center"</span><span class="p">,</span>
+      <span class="s2">"phone_number"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
+      <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span><span class="p">,</span>
+      <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">4</span><span class="p">,</span>
+      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-04-04T02:08:50Z"</span><span class="p">,</span>
+      <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94108"</span><span class="p">,</span>
+      <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+        <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135"</span><span class="p">,</span>
+        <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135"</span><span class="p">,</span>
+        <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135"</span><span class="p">,</span>
+        <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"</span>
+      <span class="p">},</span>
+      <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
+      <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"</span>
     <span class="p">}</span>
 </pre>
 </div>
@@ -713,25 +743,24 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns:  <em>Array</em> of Artists <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/event/858707/artists?api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/event/1047075/artists?api_key=1234567890abcdef</span>
     <span class="p">[</span>
       <span class="p">{</span>
-        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-28T18:56:09Z"</span><span class="p">,</span>
-        <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Rock"</span><span class="p">,</span>
-        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">4802</span><span class="p">,</span>
-        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"The Sea and Cake"</span><span class="p">,</span>
-        <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
-        <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">8</span><span class="p">,</span>
-        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-20T19:12:57Z"</span><span class="p">,</span>
-        <span class="s2">"photos"</span><span class="o">:</span>
-            <span class="p">{</span>
-              <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-              <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-medium.jpg"</span><span class="p">,</span>
-              <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-large.jpg"</span><span class="p">,</span>
-              <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-mobile.jpg"</span>
-            <span class="p">},</span>
-        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/The_Sea_and_Cake"</span>
+        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-05-19T20:27:47Z"</span><span class="p">,</span>
+        <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Operatic pop"</span><span class="p">,</span>
+        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">378465</span><span class="p">,</span>
+        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Il Volo"</span><span class="p">,</span>
+        <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">61</span><span class="p">,</span>
+        <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">30</span><span class="p">,</span>
+        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-27T15:59:04Z"</span><span class="p">,</span>
+        <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+          <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426"</span><span class="p">,</span>
+          <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426"</span><span class="p">,</span>
+          <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426"</span><span class="p">,</span>
+          <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"</span>
+        <span class="p">},</span>
+        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Il_Volo"</span>
       <span class="p">},</span>
       <span class="p">{</span>
         <span class="p">...</span>
@@ -753,31 +782,33 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns:  Venue <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/event/858707/venue?api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/event/1045602/venue?api_key=1234567890abcdef</span>
     <span class="p">{</span>
-      <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"859 O'Farrell St."</span><span class="p">,</span>
+      <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"1111 California Street"</span><span class="p">,</span>
       <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
       <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
       <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
-      <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-21T16:52:31Z"</span><span class="p">,</span>
-      <span class="s2">"id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
-      <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.784796</span><span class="p">,</span>
-      <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.418819</span><span class="p">,</span>
-      <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Great American Music Hall"</span><span class="p">,</span>
+      <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2009-08-25T19:25:27Z"</span><span class="p">,</span>
+      <span class="s2">"id"</span><span class="o">:</span> <span class="mi">63279</span><span class="p">,</span>
+      <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.79153</span><span class="p">,</span>
+      <span class="s2">"long_description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.412757</span><span class="p">,</span>
+      <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Masonic Center"</span><span class="p">,</span>
+      <span class="s2">"phone_number"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
       <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
-      <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">34</span><span class="p">,</span>
-      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-20T21:04:37Z"</span><span class="p">,</span>
-      <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94109"</span><span class="p">,</span>
+      <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span><span class="p">,</span>
+      <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">4</span><span class="p">,</span>
+      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-04-04T02:08:50Z"</span><span class="p">,</span>
+      <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94108"</span><span class="p">,</span>
+      <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+        <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135"</span><span class="p">,</span>
+        <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135"</span><span class="p">,</span>
+        <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135"</span><span class="p">,</span>
+        <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"</span>
+      <span class="p">},</span>
       <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
-      <span class="s2">"photos"</span><span class="o">:</span>
-          <span class="p">{</span>
-            <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-            <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-medium.jpg"</span><span class="p">,</span>
-            <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-large.jpg"</span><span class="p">,</span>
-            <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-mobile.jpg"</span>
-          <span class="p">}</span>
-      <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>
+      <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"</span>
     <span class="p">}</span>
 </pre>
 </div>
@@ -796,23 +827,23 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns:  <em>Array</em> of Tickets <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/event/858707/tickets?api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/event/1047075/tickets?api_key=1234567890abcdef</span>
     <span class="p">[</span>
       <span class="p">{</span>
-        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:16Z"</span><span class="p">,</span>
+        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2012-03-02T18:06:14Z"</span><span class="p">,</span>
         <span class="s2">"description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
-        <span class="s2">"event_id"</span><span class="o">:</span> <span class="mi">858707</span><span class="p">,</span>
-        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">599794</span><span class="p">,</span>
+        <span class="s2">"event_id"</span><span class="o">:</span> <span class="mi">1047075</span><span class="p">,</span>
+        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">819883</span><span class="p">,</span>
         <span class="s2">"marketing_text"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
-        <span class="s2">"max_ticket_price"</span><span class="o">:</span> <span class="mi">21</span><span class="p">,</span>
-        <span class="s2">"min_ticket_price"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
-        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Gen. Admission Seating Limited"</span><span class="p">,</span>
+        <span class="s2">"max_ticket_price"</span><span class="o">:</span> <span class="mi">85</span><span class="p">,</span>
+        <span class="s2">"min_ticket_price"</span><span class="o">:</span> <span class="mi">29</span><span class="p">,</span>
+        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Onsale to General Public"</span><span class="p">,</span>
         <span class="s2">"on_sale_end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
         <span class="s2">"on_sale_start_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
         <span class="s2">"seat_info"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
-        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:16Z"</span><span class="p">,</span>
-        <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>
+        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-02T18:06:14Z"</span><span class="p">,</span>
+        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://ticketsus.at/thrillcall?CTY=39&amp;DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&amp;brand=[=BRAND=]"</span>
       <span class="p">},</span>
       <span class="p">{</span>
         <span class="p">...</span>
@@ -848,7 +879,7 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns:  <em>Array</em> of Genres <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/genres?limit=14&amp;api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/genres?limit=14&amp;api_key=1234567890abcdef</span>
     <span class="p">[</span>
       <span class="p">{</span>
@@ -878,7 +909,7 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns: Genre <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/genre/27?api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/genre/27?api_key=1234567890abcdef</span>
     <span class="p">{</span>
       <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-07-09T19:17:45Z"</span><span class="p">,</span>
@@ -903,25 +934,24 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns:  <em>Array</em> of Artists <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/genre/27/artists?api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/genre/61/artists?api_key=1234567890abcdef</span>
     <span class="p">[</span>
       <span class="p">{</span>
-        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-29T10:06:05Z"</span><span class="p">,</span>
-        <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Folk;Other;psychedelic"</span><span class="p">,</span>
-        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">2</span><span class="p">,</span>
-        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Espers"</span><span class="p">,</span>
-        <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
-        <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
-        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-03T22:14:36Z"</span><span class="p">,</span>
-        <span class="s2">"photos"</span><span class="o">:</span>
-            <span class="p">{</span>
-              <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-              <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-medium.jpg"</span><span class="p">,</span>
-              <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-large.jpg"</span><span class="p">,</span>
-              <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-mobile.jpg"</span>
-            <span class="p">},</span>
-        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Espers"</span>
+        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-29T10:19:45Z"</span><span class="p">,</span>
+        <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"O"</span><span class="p">,</span>
+        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
+        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Hyler Jones Proteges"</span><span class="p">,</span>
+        <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">61</span><span class="p">,</span>
+        <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
+        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-26T16:49:20Z"</span><span class="p">,</span>
+        <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+          <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-thumbnail.jpg"</span><span class="p">,</span>
+          <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-medium.jpg"</span><span class="p">,</span>
+          <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-large.jpg"</span><span class="p">,</span>
+          <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-mobile.jpg"</span>
+        <span class="p">},</span>
+        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Hyler_Jones_Proteges"</span>
       <span class="p">},</span>
       <span class="p">{</span>
         <span class="p">...</span>
@@ -938,27 +968,29 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 <ul>
 <li>
-<strong>city</strong>                    <em>string</em>    City of the Metro Area</li>
+<strong>city</strong>                                <em>string</em>    City of the Metro Area</li>
 <li>
-<strong>country</strong>                 <em>string</em>    Country of the Metro Area</li>
+<strong>country</strong>                             <em>string</em>    Country of the Metro Area</li>
 <li>
-<strong>created_at</strong>             <em>string</em>    ISO 8601 representation the time this object was created</li>
+<strong>created_at</strong>                         <em>string</em>    ISO 8601 representation the time this object was created</li>
 <li>
-<strong>id</strong>                      <em>integer</em>   Thrillcall ID</li>
+<strong>id</strong>                                  <em>integer</em>   Thrillcall ID</li>
 <li>
-<strong>latitude</strong>                <em>float</em>     Latitude of the Metro Area</li>
+<strong>latitude</strong>                            <em>float</em>     Latitude of the Metro Area</li>
 <li>
-<strong>longitude</strong>               <em>float</em>     Longitude of the Metro Area</li>
+<strong>longitude</strong>                           <em>float</em>     Longitude of the Metro Area</li>
 <li>
-<strong>radius</strong>                  <em>integer</em>   Radius of the Metro Area from the Lat/Long center</li>
+<strong>radius</strong>                              <em>integer</em>   Radius of the Metro Area from the Lat/Long center</li>
 <li>
-<strong>state</strong>                   <em>string</em>    State of the Metro Area</li>
+<strong>state</strong>                               <em>string</em>    State of the Metro Area</li>
 <li>
-<strong>time_zone</strong>              <em>string</em>    Time zone of the Metro Area</li>
+<strong>time_zone</strong>                          <em>string</em>    Time zone of the Metro Area</li>
 <li>
-<strong>updated_at</strong>             <em>string</em>    ISO 8601 representation of last time this object was updated</li>
+<strong>updated_at</strong>                         <em>string</em>    ISO 8601 representation of last time this object was updated</li>
 <li>
-<strong>url</strong>                     <em>string</em>    URL for this object on Thrillcall</li>
+<strong>url</strong>                                 <em>string</em>    URL for this object on Thrillcall</li>
+<li>
+<strong>offers_availability_status_code</strong>  <em>integer</em>   Offers status for the Metro Area ( no_offers = 0, available = 1, coming_soon = 2)</li>
 </ul><h3>GET /metro_areas</h3>
 <p>Params:</p>
@@ -969,7 +1001,7 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns:  <em>Array</em> of Metro Areas <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/metro_areas?limit=14&amp;api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/metro_areas?limit=14&amp;api_key=1234567890abcdef</span>
     <span class="p">[</span>
       <span class="p">{</span>
@@ -979,10 +1011,11 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
         <span class="s2">"id"</span><span class="o">:</span> <span class="mi">104</span><span class="p">,</span>
         <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">41.8842</span><span class="p">,</span>
         <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">87.6324</span><span class="p">,</span>
+        <span class="s2">"offers_availability_status_code"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
         <span class="s2">"radius"</span><span class="o">:</span> <span class="mi">50</span><span class="p">,</span>
         <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"IL"</span><span class="p">,</span>
         <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Chicago"</span><span class="p">,</span>
-        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-07-05T23:11:24Z"</span><span class="p">,</span>
+        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-12-27T00:44:37Z"</span><span class="p">,</span>
         <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/live-music/chicago"</span>
       <span class="p">},</span>
       <span class="p">{</span>
@@ -1005,7 +1038,7 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns:  Metro Area <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/metro_area/105?api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/metro_area/105?api_key=1234567890abcdef</span>
     <span class="p">{</span>
       <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
@@ -1014,10 +1047,11 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
       <span class="s2">"id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
       <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7771</span><span class="p">,</span>
       <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.42</span><span class="p">,</span>
+      <span class="s2">"offers_availability_status_code"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
       <span class="s2">"radius"</span><span class="o">:</span> <span class="mi">50</span><span class="p">,</span>
       <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
-      <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Chicago"</span><span class="p">,</span>
-      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-07-05T23:11:24Z"</span><span class="p">,</span>
+      <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span><span class="p">,</span>
+      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-12-27T00:44:37Z"</span><span class="p">,</span>
       <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/live-music/san-francisco"</span>
     <span class="p">}</span>
 </pre>
@@ -1035,42 +1069,46 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 <li><strong><a href="#page">page</a></strong></li>
 <li><strong><a href="#min_date">min_date</a></strong></li>
 <li><strong><a href="#max_date">max_date</a></strong></li>
+<li><strong><a href="#min_updated_at">min_updated_at</a></strong></li>
+<li><strong><a href="#max_updated_at">max_updated_at</a></strong></li>
 <li><strong><a href="#radius">radius</a></strong></li>
 <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
 <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
+<li><strong><a href="#show_disabled_events">show_disabled_events</a></strong></li>
 <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
 <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
-</ul><p>Returns:  <em>Array</em> of Metro Areas <em>Hash</em></p>
+</ul><p>Note:  Time Zone is set as the time zone of the Metro Area and cannot be overridden.</p>
+<p>Returns:  <em>Array</em> of Metro Areas <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/metro_area/105/events?api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/metro_area/105/events?min_date=2011-04-05&amp;max_date=2012-04-04&amp;limit=3&amp;api_key=1234567890abcdef</span>
     <span class="p">[</span>
       <span class="p">{</span>
-        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-04-24T02:12:09Z"</span><span class="p">,</span>
-        <span class="s2">"end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2012-01-02T08:53:00Z"</span><span class="p">,</span>
         <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
-        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">831330</span><span class="p">,</span>
-        <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7794</span><span class="p">,</span>
-        <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.418</span><span class="p">,</span>
-        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Philadelphia Orchestra @ Davies Symphony Hall"</span><span class="p">,</span>
-        <span class="s2">"num_cancelled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-        <span class="s2">"num_confirmed_bookings"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
-        <span class="s2">"num_disabled_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-        <span class="s2">"num_unconfirmed_bookings"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
+        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1011386</span><span class="p">,</span>
+        <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7771</span><span class="p">,</span>
+        <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.42</span><span class="p">,</span>
+        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Kontrol @ The End Up"</span><span class="p">,</span>
         <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
         <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
-        <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2012-06-11T06:59:00Z"</span><span class="p">,</span>
+        <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2012-01-07T00:00:04Z"</span><span class="p">,</span>
+        <span class="s2">"starts_at"</span><span class="o">:</span> <span class="s2">"2012-01-07T08:00:04Z"</span><span class="p">,</span>
+        <span class="s2">"starts_at_time_trusted"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
         <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T03:51:22Z"</span><span class="p">,</span>
-        <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">51886</span><span class="p">,</span>
-        <span class="s2">"photos"</span><span class="o">:</span>
-            <span class="p">{</span>
-              <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-              <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-large.jpg"</span><span class="p">,</span>
-              <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-mobile.jpg"</span>
-            <span class="p">},</span>
-        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/831330"</span>
+        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-29T01:19:31Z"</span><span class="p">,</span>
+        <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">47273</span><span class="p">,</span>
+        <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+          <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/event/_default/default-thumbnail.jpg"</span><span class="p">,</span>
+          <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/event/_default/default-large.jpg"</span><span class="p">,</span>
+          <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-mobile.jpg?1326489566"</span>
+        <span class="p">},</span>
+        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/1011386"</span><span class="p">,</span>
+        <span class="s2">"starts_at_local"</span><span class="o">:</span> <span class="s2">"2012-01-07T00:00:04-08:00"</span><span class="p">,</span>
+        <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span>
+        <span class="s2">"status"</span><span class="o">:</span> <span class="s2">"confirmed"</span>
       <span class="p">},</span>
       <span class="p">{</span>
         <span class="p">...</span>
@@ -1105,12 +1143,51 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 <li>
 <strong>referral_code</strong>          <em>string</em>    Referral code of the Person</li>
 <li>
-<strong>referral_code_count</strong>   <em>integer</em>   Number of Referral code used for the Person</li>
+<strong>referral_credits</strong>       <em>integer</em>   Number of Referral credits the Person has (including bonus points)</li>
 <li>
 <strong>postalcode</strong>              <em>string</em>    Postalcode of the Person</li>
 <li>
 <strong>photos</strong>                  <em>hash</em>      A hash of image urls of the primary photo available for this object in different styles</li>
-</ul><h3>POST /person/signin</h3>
+</ul><h3>GET /person/:id</h3>
+<p>Params:</p>
+<ul>
+<li>None.</li>
+</ul><p>Returns: Person <em>Hash</em></p>
+<div class="highlight">
+<pre>    <span class="c1">// Example: GET /api/v3/person/49?api_key=1234567890abcdef</span>
+    <span class="p">{</span>
+      <span class="s2">"address1"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"Santa Rosa"</span><span class="p">,</span>
+      <span class="s2">"country_code"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
+      <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-10-17T18:54:31Z"</span><span class="p">,</span>
+      <span class="s2">"first_name"</span><span class="o">:</span> <span class="s2">"John"</span><span class="p">,</span>
+      <span class="s2">"gender"</span><span class="o">:</span> <span class="s2">"m"</span><span class="p">,</span>
+      <span class="s2">"id"</span><span class="o">:</span> <span class="mi">49</span><span class="p">,</span>
+      <span class="s2">"last_name"</span><span class="o">:</span> <span class="s2">"Doe"</span><span class="p">,</span>
+      <span class="s2">"login"</span><span class="o">:</span> <span class="s2">"bogus@bogus.com"</span><span class="p">,</span>
+      <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
+      <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span><span class="p">,</span>
+      <span class="s2">"timezone"</span><span class="o">:</span> <span class="s2">"-7"</span><span class="p">,</span>
+      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-28T16:07:16Z"</span><span class="p">,</span>
+      <span class="s2">"referral_code"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"referral_credits"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
+      <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"95407"</span><span class="p">,</span>
+      <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+        <span class="s2">"small_thumb"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/person/164761/1324568419/19154-small_thumb.jpg?1324568419"</span><span class="p">,</span>
+        <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/person/164761/1324568419/19154-thumbnail.jpg?1324568419"</span><span class="p">,</span>
+        <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/person/164761/1324568419/19154-medium.jpg?1324568419"</span>
+      <span class="p">}</span>
+    <span class="p">}</span>
+</pre>
+</div>
+<h3>POST /person/signin</h3>
 <p>Params:</p>
@@ -1133,25 +1210,30 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 <p>Returns: Person <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: POST /api/v2/person/signin</span>
+<pre>    <span class="c1">// Example: POST /api/v3/person/signin?provider=facebook&amp;uid=123123bogus&amp;token=123123bogus&amp;email=123123bogus%40bogus.com&amp;first_name=Mister&amp;last_name=Bogus&amp;lat=38.5&amp;long=-123.0&amp;api_key=1234567890abcdef</span>
     <span class="p">{</span>
-      <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2000-11-09T19:09:23Z"</span><span class="p">,</span>
-      <span class="s2">"first_name"</span><span class="o">:</span> <span class="s2">"John"</span><span class="p">,</span>
+      <span class="s2">"address1"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"city"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"country_code"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"created_at"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"first_name"</span><span class="o">:</span> <span class="s2">"Mister"</span><span class="p">,</span>
       <span class="s2">"gender"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
-      <span class="s2">"id"</span><span class="o">:</span> <span class="mi">49</span><span class="p">,</span>
-      <span class="s2">"last_name"</span><span class="o">:</span> <span class="s2">"Doe"</span><span class="p">,</span>
-      <span class="s2">"login"</span><span class="o">:</span> <span class="s2">"john@example.com"</span><span class="p">,</span>
-      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-11-09T19:09:23Z"</span><span class="p">,</span>
-      <span class="s2">"referral_code"</span><span class="o">:</span> <span class="s2">"fhskjfhk3j43h43hjkh"</span><span class="p">,</span>
-      <span class="s2">"referral_code_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-      <span class="s2">"photos"</span><span class="o">:</span>
-          <span class="p">{</span>
-            <span class="s2">"small_thumb"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/person/_default/default-small_thumb.jpg"</span><span class="p">,</span>
-            <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/person/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-            <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/person/_default/default-medium.jpg"</span>
-          <span class="p">},</span>
-      <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94104"</span>
+      <span class="s2">"last_name"</span><span class="o">:</span> <span class="s2">"Bogus"</span><span class="p">,</span>
+      <span class="s2">"login"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"state"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"time_zone"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"timezone"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"referral_code"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"referral_credits"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
+      <span class="s2">"postalcode"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+        <span class="s2">"small_thumb"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/person/_default/default-small_thumb.jpg"</span><span class="p">,</span>
+        <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/person/_default/default-thumbnail.jpg"</span><span class="p">,</span>
+        <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/person/_default/default-medium.jpg"</span>
+      <span class="p">}</span>
     <span class="p">}</span>
 </pre>
 </div>
@@ -1172,26 +1254,31 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns: Person <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: POST /api/v2/person/signup</span>
+<pre>    <span class="c1">// Example: POST /api/v3/person/signup?first_name=Mister&amp;email=bogus%40bogus.com&amp;password=bogus&amp;postalcode=94108&amp;api_key=1234567890abcdef</span>
     <span class="p">{</span>
-        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2000-11-09T19:09:23Z"</span><span class="p">,</span>
-        <span class="s2">"first_name"</span><span class="o">:</span> <span class="s2">"John"</span><span class="p">,</span>
-        <span class="s2">"gender"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
-        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">49</span><span class="p">,</span>
-        <span class="s2">"last_name"</span><span class="o">:</span> <span class="s2">"Doe"</span><span class="p">,</span>
-        <span class="s2">"login"</span><span class="o">:</span> <span class="s2">"john@example.com"</span><span class="p">,</span>
-        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-11-09T19:09:23Z"</span><span class="p">,</span>
-        <span class="s2">"referral_code"</span><span class="o">:</span> <span class="s2">"fhskjfhk3j43h43hjkh"</span><span class="p">,</span>
-        <span class="s2">"referral_code_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-        <span class="s2">"photos"</span><span class="o">:</span>
-          <span class="p">{</span>
-            <span class="s2">"small_thumb"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/person/_default/default-small_thumb.jpg"</span><span class="p">,</span>
-            <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/person/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-            <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/person/_default/default-medium.jpg"</span>
-          <span class="p">},</span>
-        <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94104"</span>
-     <span class="p">}</span>
+      <span class="s2">"address1"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"city"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"country_code"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"created_at"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"first_name"</span><span class="o">:</span> <span class="s2">"Mister"</span><span class="p">,</span>
+      <span class="s2">"gender"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"last_name"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"login"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"state"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"time_zone"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"timezone"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"referral_code"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"referral_credits"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
+      <span class="s2">"postalcode"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+        <span class="s2">"small_thumb"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/person/_default/default-small_thumb.jpg"</span><span class="p">,</span>
+        <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/person/_default/default-thumbnail.jpg"</span><span class="p">,</span>
+        <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/person/_default/default-medium.jpg"</span>
+      <span class="p">}</span>
+    <span class="p">}</span>
 </pre>
 </div>
@@ -1232,6 +1319,8 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 <li>
 <strong>postalcode</strong>              <em>string</em>    Postal code for the Venue</li>
 <li>
+<strong>phone_number</strong>           <em>string</em>    Phone number for the Venue (including country code)</li>
+<li>
 <strong>photos</strong>                  <em>hash</em>      A hash of image urls of the primary photo available for this object in different styles</li>
 <li>
 <strong>url</strong>                     <em>string</em>    URL for this object on Thrillcall</li>
@@ -1249,7 +1338,7 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns:  <em>Array</em> of Venues <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/venues?limit=14&amp;api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/venues?limit=14&amp;api_key=1234567890abcdef</span>
     <span class="p">[</span>
       <span class="p">{</span>
@@ -1257,23 +1346,25 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
         <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
         <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"Guadalajara"</span><span class="p">,</span>
         <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"MX"</span><span class="p">,</span>
-        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2000-11-09T19:09:23Z"</span><span class="p">,</span>
+        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-05-09T09:29:23Z"</span><span class="p">,</span>
         <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
-        <span class="s2">"latitude"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
-        <span class="s2">"long_description"</span><span class="o">:</span> <span class="s2">"Description of the venue"</span><span class="p">,</span>
-        <span class="s2">"longitude"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+        <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">20.666222</span><span class="p">,</span>
+        <span class="s2">"long_description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+        <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">103.352089</span><span class="p">,</span>
         <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Fbolko"</span><span class="p">,</span>
+        <span class="s2">"phone_number"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
         <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"MX"</span><span class="p">,</span>
+        <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Mexico_City"</span><span class="p">,</span>
         <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-28T17:24:20Z"</span><span class="p">,</span>
+        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-29T00:04:23Z"</span><span class="p">,</span>
         <span class="s2">"postalcode"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
-        <span class="s2">"photos"</span><span class="o">:</span>
-          <span class="p">{</span>
-            <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-            <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-medium.jpg"</span><span class="p">,</span>
-            <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-large.jpg"</span><span class="p">,</span>
-            <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-mobile.jpg"</span>
-          <span class="p">}</span>
+        <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+          <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-thumbnail.jpg"</span><span class="p">,</span>
+          <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-medium.jpg"</span><span class="p">,</span>
+          <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-large.jpg"</span><span class="p">,</span>
+          <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-mobile.jpg"</span>
+        <span class="p">},</span>
+        <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
         <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Fbolko_in_Guadalajara_MX"</span>
       <span class="p">},</span>
       <span class="p">{</span>
@@ -1296,32 +1387,33 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns:  Venue <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/venue/27418?api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/venue/51886?api_key=1234567890abcdef</span>
     <span class="p">{</span>
-      <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"859 O'Farrell St."</span><span class="p">,</span>
+      <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"201 Van Ness Avenue"</span><span class="p">,</span>
       <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
       <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
       <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
-      <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-21T16:52:31Z"</span><span class="p">,</span>
-      <span class="s2">"id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
-      <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.784796</span><span class="p">,</span>
-      <span class="s2">"long_description"</span><span class="o">:</span> <span class="s2">"Description of the venue"</span><span class="p">,</span>
-      <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.418819</span><span class="p">,</span>
-      <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Great American Music Hall"</span><span class="p">,</span>
+      <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-28T17:59:32Z"</span><span class="p">,</span>
+      <span class="s2">"id"</span><span class="o">:</span> <span class="mi">51886</span><span class="p">,</span>
+      <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.777402</span><span class="p">,</span>
+      <span class="s2">"long_description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+      <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.419815</span><span class="p">,</span>
+      <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Davies Symphony Hall"</span><span class="p">,</span>
+      <span class="s2">"phone_number"</span><span class="o">:</span> <span class="s2">"(415) 864-6000"</span><span class="p">,</span>
       <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
-      <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">34</span><span class="p">,</span>
-      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-20T21:04:37Z"</span><span class="p">,</span>
-      <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94109"</span><span class="p">,</span>
+      <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span><span class="p">,</span>
+      <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">48</span><span class="p">,</span>
+      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-28T03:13:27Z"</span><span class="p">,</span>
+      <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94102"</span><span class="p">,</span>
+      <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+        <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-thumbnail.jpg?1326417154"</span><span class="p">,</span>
+        <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-medium.jpg?1326417154"</span><span class="p">,</span>
+        <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-large.jpg?1326417154"</span><span class="p">,</span>
+        <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-mobile.jpg?1326417154"</span>
+      <span class="p">},</span>
       <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
-      <span class="s2">"photos"</span><span class="o">:</span>
-          <span class="p">{</span>
-            <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-            <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-medium.jpg"</span><span class="p">,</span>
-            <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-large.jpg"</span><span class="p">,</span>
-            <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-mobile.jpg"</span>
-          <span class="p">}</span>
-      <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>
+      <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Davies_Symphony_Hall_in_San_Francisco_CA"</span>
     <span class="p">}</span>
 </pre>
 </div>
@@ -1336,41 +1428,47 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 <ul>
 <li><strong><a href="#limit">limit</a></strong></li>
 <li><strong><a href="#page">page</a></strong></li>
+<li><strong><a href="#time_zone">time_zone</a></strong></li>
 <li><strong><a href="#min_date">min_date</a></strong></li>
 <li><strong><a href="#max_date">max_date</a></strong></li>
+<li><strong><a href="#min_updated_at">min_updated_at</a></strong></li>
+<li><strong><a href="#max_updated_at">max_updated_at</a></strong></li>
 <li><strong><a href="#use_partner_id">use_partner_id</a></strong></li>
 <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
 <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
+<li><strong><a href="#show_disabled_events">show_disabled_events</a></strong></li>
 <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
 <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
 </ul><p>Returns:  <em>Array</em> of Events <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/venue/32065/events?api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/venue/63279/events?api_key=1234567890abcdef</span>
     <span class="p">[</span>
       <span class="p">{</span>
-        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2000-11-09T19:09:23Z"</span><span class="p">,</span>
-        <span class="s2">"end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2012-03-02T18:06:14Z"</span><span class="p">,</span>
         <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
-        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">824614</span><span class="p">,</span>
-        <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.8016</span><span class="p">,</span>
-        <span class="s2">"long_description"</span><span class="o">:</span> <span class="s2">"Description of the venue"</span><span class="p">,</span>
-        <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">80.4462</span><span class="p">,</span>
-        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Colt Ford @ West Virginia State Fair"</span><span class="p">,</span>
+        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1047075</span><span class="p">,</span>
+        <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7915</span><span class="p">,</span>
+        <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.413</span><span class="p">,</span>
+        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Il Volo @ Masonic Center"</span><span class="p">,</span>
         <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
         <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
-        <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2011-08-21T03:59:00Z"</span><span class="p">,</span>
+        <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2012-09-29T19:30:04Z"</span><span class="p">,</span>
+        <span class="s2">"starts_at"</span><span class="o">:</span> <span class="s2">"2012-09-30T02:30:04Z"</span><span class="p">,</span>
+        <span class="s2">"starts_at_time_trusted"</span><span class="o">:</span> <span class="kc">true</span><span class="p">,</span>
         <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
-        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-06-24T05:10:05Z"</span><span class="p">,</span>
-        <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">32065</span><span class="p">,</span>
-        <span class="s2">"photos"</span><span class="o">:</span>
-            <span class="p">{</span>
-              <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-              <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-large.jpg"</span><span class="p">,</span>
-              <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-mobile.jpg"</span>
-            <span class="p">},</span>
-        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/824614"</span>
+        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-29T01:35:57Z"</span><span class="p">,</span>
+        <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">63279</span><span class="p">,</span>
+        <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+          <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426"</span><span class="p">,</span>
+          <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426"</span><span class="p">,</span>
+          <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"</span>
+        <span class="p">},</span>
+        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/1047075"</span><span class="p">,</span>
+        <span class="s2">"starts_at_local"</span><span class="o">:</span> <span class="s2">"2012-09-29T19:30:04-07:00"</span><span class="p">,</span>
+        <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span>
+        <span class="s2">"status"</span><span class="o">:</span> <span class="s2">"confirmed"</span>
       <span class="p">},</span>
       <span class="p">{</span>
         <span class="p">...</span>
@@ -1397,33 +1495,34 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns:  <em>Array</em> of Venues <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/search/venues/Great%20American%20Music%20Hall?api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/search/venues/Masonic%20Center?api_key=1234567890abcdef</span>
     <span class="p">[</span>
       <span class="p">{</span>
-        <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"859 O'Farrell St."</span><span class="p">,</span>
+        <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"525 W Riverview Ave"</span><span class="p">,</span>
         <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
-        <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
+        <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"Dayton"</span><span class="p">,</span>
         <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
-        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-21T16:52:31Z"</span><span class="p">,</span>
-        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
-        <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.784796</span><span class="p">,</span>
-        <span class="s2">"long_description"</span><span class="o">:</span> <span class="s2">"Description of the venue"</span><span class="p">,</span>
-        <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.418819</span><span class="p">,</span>
-        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Great American Music Hall"</span><span class="p">,</span>
-        <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
-        <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">34</span><span class="p">,</span>
-        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-20T21:04:37Z"</span><span class="p">,</span>
-        <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94109"</span><span class="p">,</span>
-        <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
-        <span class="s2">"photos"</span><span class="o">:</span>
-          <span class="p">{</span>
-            <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-thumbnail.jpg"</span><span class="p">,</span>
-            <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-medium.jpg"</span><span class="p">,</span>
-            <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-large.jpg"</span><span class="p">,</span>
-            <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-mobile.jpg"</span>
-          <span class="p">}</span>
-        <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>
+        <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-06-12T14:12:53Z"</span><span class="p">,</span>
+        <span class="s2">"id"</span><span class="o">:</span> <span class="mi">33642</span><span class="p">,</span>
+        <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">39.765526</span><span class="p">,</span>
+        <span class="s2">"long_description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+        <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">84.203133</span><span class="p">,</span>
+        <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Dayton Masonic Center"</span><span class="p">,</span>
+        <span class="s2">"phone_number"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
+        <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"OH"</span><span class="p">,</span>
+        <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/New_York"</span><span class="p">,</span>
+        <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
+        <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-28T03:11:49Z"</span><span class="p">,</span>
+        <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"45405"</span><span class="p">,</span>
+        <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
+          <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-thumbnail.jpg"</span><span class="p">,</span>
+          <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-medium.jpg"</span><span class="p">,</span>
+          <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-large.jpg"</span><span class="p">,</span>
+          <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-mobile.jpg"</span>
+        <span class="p">},</span>
+        <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">134</span><span class="p">,</span>
+        <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Dayton_Masonic_Center_in_Dayton_OH"</span>
       <span class="p">},</span>
       <span class="p">{</span>
         <span class="p">...</span>
@@ -1472,19 +1571,23 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 <ul>
 <li><strong><a href="#limit">limit</a></strong></li>
 <li><strong><a href="#page">page</a></strong></li>
+<li><strong><a href="#time_zone">time_zone</a></strong></li>
 <li><strong><a href="#min_date">min_date</a></strong></li>
 <li><strong><a href="#max_date">max_date</a></strong></li>
+<li><strong><a href="#min_updated_at">min_updated_at</a></strong></li>
+<li><strong><a href="#max_updated_at">max_updated_at</a></strong></li>
 <li><strong><a href="#lat">lat</a></strong></li>
 <li><strong><a href="#long">long</a></strong></li>
 <li><strong><a href="#postalcode">postalcode</a></strong></li>
 <li><strong><a href="#radius">radius</a></strong></li>
 <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
+<li><strong><a href="#show_disabled_events">show_disabled_events</a></strong></li>
 <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
 <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
 </ul><p>Returns:  <em>Array</em> of Tickets <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/tickets?limit=14&amp;api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/tickets?limit=14&amp;api_key=1234567890abcdef</span>
     <span class="p">[</span>
       <span class="p">{</span>
@@ -1522,22 +1625,22 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
 </ul><p>Returns:  Ticket <em>Hash</em></p>
 <div class="highlight">
-<pre>    <span class="c1">// Example: GET /api/v2/ticket/599794?api_key=1234567890abcdef</span>
+<pre>    <span class="c1">// Example: GET /api/v3/ticket/819883?api_key=1234567890abcdef</span>
     <span class="p">{</span>
-      <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:16Z"</span><span class="p">,</span>
+      <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2012-03-02T18:06:14Z"</span><span class="p">,</span>
       <span class="s2">"description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
-      <span class="s2">"event_id"</span><span class="o">:</span> <span class="mi">858707</span><span class="p">,</span>
-      <span class="s2">"id"</span><span class="o">:</span> <span class="mi">599794</span><span class="p">,</span>
+      <span class="s2">"event_id"</span><span class="o">:</span> <span class="mi">1047075</span><span class="p">,</span>
+      <span class="s2">"id"</span><span class="o">:</span> <span class="mi">819883</span><span class="p">,</span>
       <span class="s2">"marketing_text"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
-      <span class="s2">"max_ticket_price"</span><span class="o">:</span> <span class="mi">21</span><span class="p">,</span>
-      <span class="s2">"min_ticket_price"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
-      <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Gen. Admission Seating Limited"</span><span class="p">,</span>
+      <span class="s2">"max_ticket_price"</span><span class="o">:</span> <span class="mi">85</span><span class="p">,</span>
+      <span class="s2">"min_ticket_price"</span><span class="o">:</span> <span class="mi">29</span><span class="p">,</span>
+      <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Onsale to General Public"</span><span class="p">,</span>
       <span class="s2">"on_sale_end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
       <span class="s2">"on_sale_start_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
       <span class="s2">"seat_info"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
-      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-06-14T00:09:16Z"</span><span class="p">,</span>
-      <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>
+      <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-02T18:06:14Z"</span><span class="p">,</span>
+      <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://ticketsus.at/thrillcall?CTY=39&amp;DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&amp;brand=[=BRAND=]"</span>
     <span class="p">}</span>
 </pre>
 </div>