Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Thrillcall API Client Ruby Gem

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 autotest
Octocat-spinner-32 docs
Octocat-spinner-32 lib
Octocat-spinner-32 script
Octocat-spinner-32 spec
Octocat-spinner-32 .autotest
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .rspec
Octocat-spinner-32 .ruby-gemset
Octocat-spinner-32 .ruby-version
Octocat-spinner-32 Gemfile
Octocat-spinner-32 Gemfile.lock
Octocat-spinner-32 README.md
Octocat-spinner-32 Rakefile
Octocat-spinner-32 thrillcall-api.gemspec
README.md

Thrillcall API

This document describes the Thrillcall API v3, and usage for the provided Ruby API wrapper gem.

Ruby API Wrapper

Usage:

    #---------------------------------------------------------------#
    # First, require the gem:
    #---------------------------------------------------------------#
    require 'rubygems'
    require 'thrillcall-api'

    #---------------------------------------------------------------#
    # Instantiate with your Thrillcall API key:
    #---------------------------------------------------------------#
    MY_API_KEY = "1234567890abcdef"
    tc = ThrillcallAPI.new(MY_API_KEY)

    #---------------------------------------------------------------#
    # Access any endpoint directly from the instance
    #---------------------------------------------------------------#
    # This is like calling GET "/events"
    tc.events
    # => [ {"id" => ... }, {...}, ...]

    #---------------------------------------------------------------#
    # Provide IDs as arguments
    #---------------------------------------------------------------#
    # GET "/event/1"
    tc.event(1)
    # => {"id" => 1, ...}

    #---------------------------------------------------------------#
    # Provide parameters as arguments
    #---------------------------------------------------------------#
    # GET "/events?limit=5"
    events = tc.events(:limit => 5)
    # => [ {"id" => ... }, {...}, ...]
    events.length
    # => 5

    #---------------------------------------------------------------#
    # Chain methods together for nested routes
    #---------------------------------------------------------------#
    # GET "/search/venues/warfield?postalcode=94101&radius=20"
    venues = tc.search.venues("warfield", :postalcode => "94101", :radius => 20)
    # => [{"name" => "The Warfield", ...}]

    #---------------------------------------------------------------#
    # POST and PUT are explicit methods
    #---------------------------------------------------------------#
    artist = tc.artist.post(:name => "Bleeding Chest Wounds")
    # => {"id" => 3, "name" => "Bleeding Chest Wounds", ...}

    artist = tc.artist(3).put(:name => "Grizzle and The Plenty")
    # => {"id" => 3, "name" => "Grizzle and The Plenty", ...}

Advanced Usage:

Provide additional instantiation options:

    #---------------------------------------------------------------#
    # The default SSL endpoint is "https://api.thrillcall.com/api/".
    # The default API version is 3.
    # By default, Faraday access logging is turned off.
    # If a connection attempt fails, we will retry 5 times with a
    # timeout of 10 seconds.  We retry a boilerplate list of
    # exceptions, such as Faraday::Error::ClientError.
    # Override these if necessary:
    #---------------------------------------------------------------#
    tc = ThrillcallAPI.new(
      MY_API_KEY,
      :base_url         => "https://api.thrillcall.com/custom/",
      :version          => 3,
      :logger           => true,
      :retry_exceptions => [Timeout::Error],
      :retry_tries      => 5,
      :timeout          => 10
    )

Internally, the wrapper returns a ThrillcallAPI::Result class for any call. Data for the request is fetched only when used. This allows you to build requests piecemeal before executing them.

    #---------------------------------------------------------------#
    # Build a partial request, add on to it later
    #---------------------------------------------------------------#
    request = tc.artist(22210) # Lady Gaga

    # GET "/artist/22210/events?limit=2"
    artist_events = request.events(:limit => 2)

    artist_events.length
    # => 2

This gem is a convenience wrapper around the excellent Faraday project. If more complicated use cases are necessary, consider using Faraday directly.

    require 'faraday'
    require 'json'

    MY_API_KEY  = "1234567890abcdef"
    BASE_URL    = "https://api.thrillcall.com/api/v3/"
    HEADERS     = { :accept => 'application/json' }

    connection  = Faraday.new( :url => BASE_URL, :headers => HEADERS ) do |builder|
      builder.adapter Faraday.default_adapter
      builder.response :logger
      builder.response :raise_error
    end

    request = connection.get do |req|
      req.url "artist/22210", { :api_key => MY_API_KEY }
    end

    artist = JSON.parse(request.body)

    artist["name"]
    # => "Lady Gaga"

HTTPS Endpoints

Contents

SSL/TLS Endpoints Required:

All API access must use the secure HTTPS endpoint : https://api.thrillcall.com:443 Access over an insecure HTTP (port 80) endpoint is now deprecated and will be disabled.

Parameters

These are valid parameters for any endpoint, however, they will only be used by the server where applicable.

api_key MUST BE SUPPLIED for every endpoint.

  • api_key string: (format: length == 16)

    Your API key. Required for access to any endpoint.

  • ids string

    Default: nil

    Comma-separated list of ID integers, like "100,200,300".

    If provided to a list endpoint (e.g. /venues), will retrieve only the specific venue ids listed.

  • limit integer

    Default: 200

    Sets the maximum number of results to return. Cannot be above 200.

  • page integer

    Default: 0

    Used in conjunction with limit.

    Specifies the page number. If limit is 10, then page = 2 will return results #20 through #29

  • time_zone string (format: TZ Database string, eg "America/Los_Angeles")

    Default: UTC For Metro Area endpoints, the default is instead the Metro Area's time zone and cannot be overridden.

    min_date and max_date will be calculated based on this time zone.

  • min_date string (format: "YYYY-MM-DD")

    Default: Today

    Results before this date will not be returned.

  • max_date string (format: "YYYY-MM-DD")

    Default: 1 year from Today

    Results after this date will not be returned.

  • min_updated_at string (format: "YYYY-MM-DD")

    Default: none

    Results with updated_at columns before this date will not be returned.

  • max_updated_at string (format: "YYYY-MM-DD")

    Default: none

    Results with updated_at columns after this date will not be returned.

  • lat float

    Default: none

    If latitude (lat) and longitude (long) if both are specified, results will be within radius of this location.

    For Person queries, this specifies the latitude of the person's location.

  • long float

    Default: none

    If latitude (lat) and longitude (long) if both are specified, results will be within radius of this location.

    For Person queries, this specifies the longitude of the person's location.

  • postalcode string (format: length >= 5)

    Default: none

    For GET requests: Results will be within the radius of this postal code. If latitude (lat) and longitude (long) if both are specified, this will be ignored.

    For POST / PUT requests: Required for creating or updating a Person or Venue.

  • radius float

    Default: 100.0

    Used in conjunction with lat/long or postalcode

  • ticket_type string (format: "primary" or "resale")

    Default: both

    If specified, will only return tickets from Primary or Resale merchants.

  • must_have_tickets boolean

    Default: false

    If set to true or 1, will only return results that have tickets associated with them.

  • show_disabled_events boolean

    Default: false

    If set to true or 1, will not filter out events which have been disabled internally.

  • show_unconfirmed_events boolean

    Default: false

    If set to true or 1, will not filter out events with unconfirmed locations.

  • show_rumor_events boolean

    Default: false

    If set to true or 1, will not filter out events marked as rumored.

  • featured_events_only boolean

    Default: false

    If set to true , will only return featured events.

  • primary_genre_id integer

    Default: none

    If set, will filter Artist results to only those with the specified primary_genre_id

  • email string

    The email address associated with a Person, required for registration.

  • password string (format: 40 >= length >= 5)

    The Person's password.

    When creating a Person, this must be supplied along with email unless using provider / uid / token auth.

    When updating a Person, this will change the Person's password. It must be supplied along with old_password.

  • old_password string (format: 40 >= length >= 5)

    The Person's current password, supplied along with password to update a Person's password.

  • provider string

    The name of the authentication provider (e.g. "facebook").

    For registration, this must be supplied along with uid and token unless using email/password auth.

  • uid string

    The Person's ID with provider.

    For registration, this must be supplied along with provider and token unless using email/password auth.

  • token string

    The Person's authentication token with provider.

    For registration, this must be supplied along with provider and uid unless using email/password auth.

    For additional credentials, this field is optional.

  • old_token string

    The Credential's current token, must match record to perform Credential updates.

  • first_name string (format: 50 >= length >= 2)

    Required to register a Person.

  • last_name string (format: 50 >= length >= 2)

    Optional for creating or updating a Person.

  • gender string (format: length == 1)

    Optional for creating or updating a Person.

  • address1 string

    Optional for creating or updating a Person, required for Venues.

  • address2 string

    Optional parameter for Person or Venue.

  • city string

    Optional for creating or updating a Person, required for Venues.

  • state string

    Optional for creating or updating a Person, required for Venues.

  • country_code string (format: "US" length == 2)

    Country code, required for Venues.

  • location_name string (format: "City, ST or City, State", length > 0))

    The name of the Person's location when auto-registering. Either this or lat / long must be provided.

  • platform string

    Default: web

    Platform of origin for tracking an object. Valid platforms: "ios", "web", "android"

  • referral_code string

    The referral code to be used during registration. Both the owner of the code as well as the new Person will receive a referral credit point.

  • preferred_radius float

    Default: 100.0

    Person's search radius preference, used as a default for Person endpoints such as GET /person/:id/recommended_events.

  • name string

    Name of the Artist or Venue.

  • facebook_url string (format: "http://facebook.com/ladygaga")

    Facebook URL for the Artist or Venue.

  • myspace_url string (format: "http://myspace.com/ladygaga")

    Myspace URL for the Artist.

  • official_url string (format: "http://www.ladygaga.com/")

    Official URL for the Artist or Venue.

  • wikipedia_url string (format: "http://en.wikipedia.org/wiki/Lady_Gaga")

    Wikipedia URL for the Artist.

  • artist_names string

    A list of comma separated artist names.

  • mappings string or array (format: ["myspace", "livenation"])

    Foreign ID mappings for the specified partners, if available, will be provided along with the object data. Can be provided as a single param ("mappings=myspace") or as an array ("mappings[]=myspace&mappings[]=livenation").

  • person_id string

    Thrillcall ID for the Person object.

  • partner_id string

    Name of the partner for foreign ID mappings, e.g. "myspace"

  • partner_obj_id string or integer

    Foreign ID for mappings, can be a string or integer.

  • partner_display_name string

    Name of the object from the partner's perspective, optional. Use to specify a name other than the one supplied in the Thrillcall object.

  • tc_obj_id integer

    Thrillcall ID for foreign ID mappings.

  • obj_type string

    Object type for foreign ID mappings, e.g. "artist"

  • sort string

    The name of the field you wish to sort by, e.g. "created_at".

    When searching by radius, or from the Metro Area endpoint, you can also specify "distance," although this value is not directly exposed.

    Calls for Artists, Genres, Tickets, Venues, and all Search endpoints default to using the "name" field. Calls for Events default to the "starts_at" field. Calls for Metro Areas default to the "city" field. Calls for Mappings default to the "partner_id" field.

  • order string: "ASC" or "DESC"

    The direction you wish to sort the results. Default: DESC

Artists

Fields:

  • created_at string ISO 8601 representation the time this object was created
  • genre_tags string Semicolon separated list of Genre names
  • id integer Thrillcall ID
  • name string Artist / Band Name
  • primary_genre_id integer The Thrillcall ID for this artist's primary Genre
  • upcoming_events_count integer Number of upcoming events associated with this object
  • updated_at string ISO 8601 representation of last time this object was updated
  • popularity float A number from 0.0 to 1.0 indicating relative popularity of the Artist, 1.0 being most popular
  • photos hash A hash of image urls of the primary photo available for this object in different styles
  • url string URL for this object on Thrillcall
  • facebook_url string URL for this object on Facebook
  • myspace_url string Myspace URL for this object
  • official_url string Official external URL for this object
  • wikipedia_url string Wikipedia URL for this object

GET /artists

Params:

Returns: Array of Artists Hash

    // Example: GET /api/v3/artists?mappings=ticketmaster&limit=14&api_key=1234567890abcdef

    [
      {
        "created_at": "2008-04-29T10:19:45Z",
        "genre_tags": "O",
        "id": 1,
        "name": "Hyler Jones Proteges",
        "primary_genre_id": 61,
        "popularity": 0.0,
        "upcoming_events_count": 0,
        "updated_at": "2010-03-26T16:49:20Z",
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/_default/default-thumbnail.jpg",
          "medium": "http://i1.tc-core.com/artist/_default/default-medium.jpg",
          "large": "http://i1.tc-core.com/artist/_default/default-large.jpg",
          "mobile": "http://i1.tc-core.com/artist/_default/default-mobile.jpg"
        },
        "url": "http://thrillcall.com/artist/Hyler_Jones_Proteges"
      },
      {
        ...
      },
      ...
    ]

POST /artist

Params:

Creates a new Artist record with the provided parameters.

Returns: Artist Hash

    // Example: GET /api/v3/artist?name=Bleeding%20Chest%20Wounds&wikipedia_url=http%3A%2F%2Ftest.com&api_key=1234567890abcdef

    {
      "created_at": null,
      "facebook_url": null,
      "genre_tags": null,
      "myspace_url": null,
      "name": "Bleeding Chest Wounds",
      "official_url": null,
      "popularity": 0.0,
      "permalink": null,
      "primary_genre_id": null,
      "upcoming_events_count": 0,
      "updated_at": null,
      "wikipedia_url": "http://test.com",
      "photos": {
        "thumbnail": "http://i1.tc-core.com/artist/_default/default-thumbnail.jpg",
        "medium": "http://i1.tc-core.com/artist/_default/default-medium.jpg",
        "large": "http://i1.tc-core.com/artist/_default/default-large.jpg",
        "mobile": "http://i1.tc-core.com/artist/_default/default-mobile.jpg"
      }
    }

GET /artist/:id

:id integer Thrillcall or Mapping

Params:

Returns: Artist Hash

    // Example: GET /api/v3/artist/12?mappings=livenation&api_key=1234567890abcdef
    {
      "created_at": "2008-05-08T18:33:35Z",
      "facebook_url": null,
      "genre_tags": "classic rock",
      "id": 12,
      "myspace_url": "http://www.myspace.com/southsidejohnnyandtheasburyjukes",
      "name": "Southside Johnny And The Asbury Jukes",
      "official_url": "http://www.southsidejohnny.com/",
      "primary_genre_id": 27,
      "popularity": 0.0,
      "upcoming_events_count": 9,
      "updated_at": "2012-06-18T07:49:24Z",
      "wikipedia_url": "http://en.wikipedia.org/wiki/Southside_Johnny_%26_The_Asbury_Jukes",
      "foreign_mappings": [
        {
          "created_at": "2009-08-13T04:41:27Z",
          "id": 11504,
          "obj_type": "artist",
          "partner_display_name": "Southside Johnny",
          "partner_id": "livenation",
          "partner_obj_id": "28610",
          "updated_at": "2012-07-18T00:19:25Z"
        },
        {
          "created_at": "2009-08-13T04:41:27Z",
          "id": 11505,
          "obj_type": "artist",
          "partner_display_name": "Southside Johnny & The Asbury Jukes",
          "partner_id": "livenation",
          "partner_obj_id": "6208",
          "updated_at": "2012-07-18T00:19:25Z"
        }
      ],
      "photos": {
        "thumbnail": "http://i1.tc-core.com/artist/12/2778/1324557379/southside-johnny-and-the-asbury-jukes-thumbnail.jpg?1324557379",
        "medium": "http://i1.tc-core.com/artist/12/2778/1324557379/southside-johnny-and-the-asbury-jukes-medium.jpg?1324557379",
        "large": "http://i1.tc-core.com/artist/12/2778/1324557379/southside-johnny-and-the-asbury-jukes-large.jpg?1324557379",
        "mobile": "http://i1.tc-core.com/artist/12/2778/1324557379/southside-johnny-and-the-asbury-jukes-mobile.jpg?1324557379"
      },
      "url": "http://localhost:3000/artist/Southside_Johnny_And_The_Asbury_Jukes"
    }

PUT /artist/:id

:id integer Thrillcall or Mapping

Params:

Updates the provided fields on Artist :id.

Returns: Artist Hash

    // Example: PUT /api/v3/artist/12569?wikipedia_url=http%3A%2F%2Ftest.com&api_key=1234567890abcdef

    {
      "created_at": "2008-04-21T16:53:17Z",
      "facebook_url": null,
      "genre_tags": "acoustic;Country;Rock;rockabilly",
      "id": 12569,
      "myspace_url": "http://www.myspace.com/chrisisaak",
      "name": "Chris Isaak",
      "official_url": "http://www.chrisisaak.com/",
      "primary_genre_id": 27,
      "popularity": 0.0,
      "upcoming_events_count": 58,
      "updated_at": "2012-07-02T09:55:40Z",
      "wikipedia_url": "http://test.com",
      "photos": {
        "thumbnail": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-thumbnail.jpg?1324556547",
        "medium": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-medium.jpg?1324556547",
        "large": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-large.jpg?1324556547",
        "mobile": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-mobile.jpg?1324556547"
      },
      "url": "http://thrillcall.com/artist/Chris_Isaak"
    }

GET /artist/:id/events

:id integer Thrillcall or Mapping

Params:

Returns: Array of Events Hash

    // Example: GET /api/v3/artist/378465/events?api_key=1234567890abcdef

    [
      {
        "created_at": "2012-03-02T18:06:14Z",
        "festival": false,
        "id": 1047075,
        "latitude": 37.7915,
        "longitude": -122.413,
        "name": "Il Volo @ Masonic Center",
        "rumor": false,
        "starts_at": "2012-09-30T02:30:04Z",
        "starts_at_time_trusted": true,
        "unconfirmed_location": 0,
        "updated_at": "2012-03-29T01:35:57Z",
        "venue_id": 63279,
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
          "large": "http://i1.tc-core.com/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
          "mobile": "http://i1.tc-core.com/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
        },
        "url": "http://thrillcall.com/event/1047075",
        "starts_at_local": "2012-09-29T19:30:04-07:00",
        "time_zone": "America/Los_Angeles",
        "event_status": "confirmed",
        "name_modified": false,
        "featured_event": false,
        "venue": {
          "address1": "1111 California Street",
          "address2": null,
          "city": "San Francisco",
          "country_code": "US",
          "created_at": "2009-08-25T19:25:27Z",
          "facebook_url": "http://www.facebook.com/pages/Nob-Hill-Masonic-Center/152483968103491",
          "hide_resale_tickets": false,
          "id": 63279,
          "latitude": 37.79153,
          "long_description": null,
          "longitude": -122.412757,
          "myspace_url": "http://www.myspace.com/masonicauditorium",
          "name": "Masonic Center",
          "official_url": "http://www.masonicauditorium.com/",
          "phone_number": "+1 (877) 598-8497",
          "state": "CA",
          "time_zone": "America/Los_Angeles",
          "upcoming_events_count": 10,
          "updated_at": "2012-07-03T09:41:24Z",
          "postalcode": "94108",
          "photos": {
            "thumbnail": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135",
            "medium": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135",
            "large": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135",
            "mobile": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"
          },
          "metro_area_id": 105,
          "url": "http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"
        },
        "artists": [
          {
            "id": 378465,
            "name": "Il Volo",
            "headliner": false
          }
        ],
        "offer_details": {}
      },
      {
        ...
      },
      ...
    ]

GET /search/artists/:term

:term string Arbitrary search string on the name field. (alphanumerics only, underscore matches underscore, use '+' for space)

Params:

Returns: Array of Artists Hash

    // Example: GET /api/v3/search/artists/Chris%20Isaak?api_key=1234567890abcdef

    [
      {
        "created_at": "2008-04-21T16:53:17Z",
        "facebook_url": null,
        "genre_tags": "acoustic;Country;Rock;rockabilly",
        "id": 12569,
        "myspace_url": "http://www.myspace.com/chrisisaak",
        "name": "Chris Isaak",
        "official_url": "http://www.chrisisaak.com/",
        "primary_genre_id": 27,
        "popularity": 0.0,
        "upcoming_events_count": 58,
        "updated_at": "2012-07-02T09:55:40Z",
        "wikipedia_url": "http://en.wikipedia.org/wiki/Chris_Isaak",
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-thumbnail.jpg?1324556547",
          "medium": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-medium.jpg?1324556547",
          "large": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-large.jpg?1324556547",
          "mobile": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-mobile.jpg?1324556547"
        },
        "url": "http://thrillcall.com/artist/Chris_Isaak"
      },
      {
        ...
      },
      ...
    ]

Events

Fields:

  • created_at string ISO 8601 representation the time this object was created
  • festival boolean Is this event a festival?
  • id integer Thrillcall ID
  • latitude float Approximate latitude for the Event
  • longitude float Approximate longitude for the Event
  • name string Name of the Event
  • on_sale_date string ISO 8601 representation of the date when tickets go on sale
  • rumor boolean Are the details for this event based on a rumor?
  • event_status string Status of the event (confirmed, unconfirmed, cancelled, or disabled)
  • starts_at string ISO 8601 representation of the start of the Event in UTC time
  • starts_at_local string ISO 8601 representation of the start of the Event in the local timezone
  • starts_at_time_trusted boolean Do we trust that the time of day component of starts_at is valid?
  • time_zone string TZ Database string representing the time zone at the location of the event
  • unconfirmed_location integer If 1, the location of this event is unconfirmed
  • updated_at string ISO 8601 representation of last time this object was updated
  • name_modified boolean Has the event name been modified?
  • featured_event boolean Is this a featured event?
  • venue_id integer Thrillcall Venue ID
  • photos hash A hash of image urls of the primary photo available for this object in different styles
  • artists array An array of hashes, each representing an artist at this event, containing:
    • id integer Thrillcall ID for the Event
    • name string Artist name
    • headliner boolean Is this artist a headliner on the bill?
    • photos hash A hash of image urls of the primary photo available for this object in different styles
  • url string URL for this object on Thrillcall
  • offer_details hash A hash of of attributes consisting of offer details about an offer attached to an event, if present
    • id integer Offer ID
    • title string Offer title
    • offer_starts_at string ISO 8601 representation of the start of the Offer in UTC time
    • offer_starts_at_local string ISO 8601 representation of the start of the Offer in local timezone
    • offer_end_at string ISO 8601 representation of the end of the Offer in UTC time
    • offer_starts_at_local string ISO 8601 representation of the end of the Offer in local timezone
    • offer_sale_starts_at string ISO 8601 representation of the start of the Offer sale in UTC time
    • offer_sale_starts_at_local string ISO 8601 representation of the start of the Offer sale in local timezone
    • short_description string Short description of the offer
    • offer_type string Type of the offer ( contest, standard )
    • price_cents integer Price of the offer in cents
    • photos hash A hash of offer photos (currently only returns 'mobile' style photos)

GET /events

Params:

Returns: Array of Events Hash

    // Example: GET /api/v3/events?must_have_tickets=true&postalcode=94108&radius=10&limit=3&api_key=1234567890abcdef

    [
      {
        "created_at": "2012-03-02T18:06:14Z",
        "festival": false,
        "id": 1047075,
        "latitude": 37.7915,
        "longitude": -122.413,
        "name": "Il Volo @ Masonic Center",
        "rumor": false,
        "starts_at": "2012-09-30T02:30:04Z",
        "starts_at_time_trusted": true,
        "unconfirmed_location": 0,
        "updated_at": "2012-03-29T01:35:57Z",
        "venue_id": 63279,
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
          "large": "http://i1.tc-core.com/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
          "mobile": "http://i1.tc-core.com/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
        },
        "url": "http://thrillcall.com/event/1047075",
        "starts_at_local": "2012-09-29T19:30:04-07:00",
        "time_zone": "America/Los_Angeles",
        "event_status": "confirmed",
        "name_modified": false,
        "featured_event": true,
        "venue": {
          "address1": "1111 California Street",
          "address2": null,
          "city": "San Francisco",
          "country_code": "US",
          "created_at": "2009-08-25T19:25:27Z",
          "facebook_url": "http://www.facebook.com/pages/Nob-Hill-Masonic-Center/152483968103491",
          "hide_resale_tickets": false,
          "id": 63279,
          "latitude": 37.79153,
          "long_description": null,
          "longitude": -122.412757,
          "myspace_url": "http://www.myspace.com/masonicauditorium",
          "name": "Masonic Center",
          "official_url": "http://www.masonicauditorium.com/",
          "phone_number": "+1 (877) 598-8497",
          "state": "CA",
          "time_zone": "America/Los_Angeles",
          "upcoming_events_count": 10,
          "updated_at": "2012-07-03T09:41:24Z",
          "postalcode": "94108",
          "photos": {
            "thumbnail": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135",
            "medium": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135",
            "large": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135",
            "mobile": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"
          },
          "metro_area_id": 105,
          "url": "http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"
        },
        "artists": [
          {
            "id": 378465,
            "name": "Il Volo",
            "headliner": false
          }
        ],
        "offer_details": {
          "id": 123,
          "title": "Example Offer",
          "offer_starts_at": "2013-05-01T09:00:00-07:00",
          "offer_starts_at_local": "2013-05-01T09:00:00-07:00",
          "offer_ends_at": "2013-05-02T17:00:00-07:00",
          "offer_ends_at_local": "2013-05-02T17:00:00-07:00",
          "offer_sale_starts_at": "2013-05-01T09:00:00-07:00",
          "offer_sale_starts_at_local": "2013-05-01T09:00:00-07:00",
          "short_description": "Win tickets for the show!",
          "offer_type": "contest",
          "price_cents": 0
        }
      },
      {
        ...
      },
      ...
    ]

GET /event/:id

:id integer Thrillcall ID

Params:

  • None

Returns: Event Hash

    // Example: GET /api/v3/event/1047075?api_key=1234567890abcdef
    {
      "created_at": "2012-03-02T18:06:14Z",
      "festival": false,
      "id": 1047075,
      "latitude": 37.7915,
      "longitude": -122.413,
      "name": "Il Volo @ Masonic Center",
      "rumor": false,
      "starts_at": "2012-09-30T02:30:04Z",
      "starts_at_time_trusted": true,
      "unconfirmed_location": 0,
      "updated_at": "2012-03-29T01:35:57Z",
      "venue_id": 63279,
      "photos": {
        "thumbnail": "http://i1.tc-core.com/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
        "large": "http://i1.tc-core.com/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
        "mobile": "http://i1.tc-core.com/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
      },
      "url": "http://thrillcall.com/event/1047075",
      "starts_at_local": "2012-09-29T19:30:04-07:00",
      "time_zone": "America/Los_Angeles",
      "event_status": "confirmed",
      "name_modified": false,
      "featured_event": true,
      "artists": [
        {
          "id": 378465,
          "name": "Il Volo",
          "headliner": false
        }
      ],
      "offer_details": {
        "id": 123,
        "title": "Example Offer",
        "offer_starts_at": "2013-05-01T09:00:00-07:00",
        "offer_starts_at_local": "2013-05-01T09:00:00-07:00",
        "offer_ends_at": "2013-05-02T17:00:00-07:00",
        "offer_ends_at_local": "2013-05-02T17:00:00-07:00",
        "offer_sale_starts_at": "2013-05-01T09:00:00-07:00",
        "offer_sale_starts_at_local": "2013-05-01T09:00:00-07:00",
        "short_description": "Get tickets for tonight!",
        "offer_type": "standard",
        "price_cents": 2000
      }
    }

GET /event/:id/artists

:id integer Thrillcall ID

Params:

Returns: Array of Artists Hash

    // Example: GET /api/v3/event/1113134/artists?api_key=1234567890abcdef

    [
      {
        "created_at": "2008-04-21T16:53:17Z",
        "facebook_url": null,
        "genre_tags": "acoustic;Country;Rock;rockabilly",
        "id": 12569,
        "myspace_url": "http://www.myspace.com/chrisisaak",
        "name": "Chris Isaak",
        "official_url": "http://www.chrisisaak.com/",
        "primary_genre_id": 27,
        "popularity": 0.0,
        "upcoming_events_count": 58,
        "updated_at": "2012-07-02T09:55:40Z",
        "wikipedia_url": "http://en.wikipedia.org/wiki/Chris_Isaak",
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-thumbnail.jpg?1324556547",
          "medium": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-medium.jpg?1324556547",
          "large": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-large.jpg?1324556547",
          "mobile": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-mobile.jpg?1324556547"
        },
        "url": "http://thrillcall.com/artist/Chris_Isaak"
      },
      {
        ...
      },
      ...
    ]

GET /event/:id/venue

:id integer Thrillcall ID

Params:

Returns: Venue Hash

    // Example: GET /api/v3/event/1113134/venue?api_key=1234567890abcdef

    {
      "address1": "1111 California Street",
      "address2": null,
      "city": "San Francisco",
      "country_code": "US",
      "created_at": "2009-08-25T19:25:27Z",
      "facebook_url": "http://www.facebook.com/pages/Nob-Hill-Masonic-Center/152483968103491",
      "hide_resale_tickets": false,
      "id": 63279,
      "latitude": 37.79153,
      "long_description": null,
      "longitude": -122.412757,
      "myspace_url": "http://www.myspace.com/masonicauditorium",
      "name": "Masonic Center",
      "official_url": "http://www.masonicauditorium.com/",
      "phone_number": "+1 (877) 598-8497",
      "state": "CA",
      "time_zone": "America/Los_Angeles",
      "upcoming_events_count": 10,
      "updated_at": "2012-07-03T09:41:24Z",
      "postalcode": "94108",
      "photos": {
        "thumbnail": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135",
        "medium": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135",
        "large": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135",
        "mobile": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"
      },
      "metro_area_id": 105,
      "url": "http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"
    }

GET /event/:id/tickets

:id integer Thrillcall ID

Params:

Returns: Array of Tickets Hash

    // Example: GET /api/v3/event/1047075/tickets?api_key=1234567890abcdef

    [
      {
        "created_at": "2012-03-02T18:06:14Z",
        "currency": "USD",
        "description": null,
        "event_id": 1047075,
        "id": 819883,
        "marketing_text": null,
        "max_ticket_price": "85.00",
        "min_ticket_price": "29.00",
        "name": "Onsale to General Public",
        "on_sale_end_date": null,
        "on_sale_start_date": null,
        "seat_info": null,
        "updated_at": "2012-03-02T18:06:14Z",
        "url": "http://ticketsus.at/thrillcall?CTY=39&DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&brand=[=BRAND=]"
      },
      {
        ...
      },
      ...
    ]

Genre

Fields:

  • created_at string ISO 8601 representation the time this object was created
  • description string Description of the Genre
  • id integer Thrillcall ID
  • name string Name of the Genre
  • updated_at string ISO 8601 representation of last time this object was updated

GET /genres

Params:

Returns: Array of Genres Hash

    // Example: GET /api/v3/genres?limit=14&api_key=1234567890abcdef

    [
      {
        "created_at": "2008-07-09T19:17:45Z",
        "description": "Shawn Colvin, Loudon Wainwright III etc...",
        "id": 6,
        "name": "Folk",
        "updated_at": "2010-03-25T23:51:55Z"
      },
      {
        ...
      },
      ...
    ]

GET /genre/:id

:id integer Thrillcall ID

Params:

  • None

Returns: Genre Hash

    // Example: GET /api/v3/genre/27?api_key=1234567890abcdef

    {
      "created_at": "2008-07-09T19:17:45Z",
      "description": "U2, 30 Seconds To Mars etc...",
      "id": 27,
      "name": "Rock",
      "updated_at": "2010-03-25T23:52:21Z"
    }

GET /genre/:id/artists

:id integer Thrillcall ID

Params:

Returns: Array of Artists Hash

    // Example: GET /api/v3/genre/27/artists?api_key=1234567890abcdef

    [
      {
        "created_at": "2008-04-29T10:06:05Z",
        "facebook_url": null,
        "genre_tags": "Folk;Other;psychedelic",
        "id": 2,
        "myspace_url": "http://www.myspace.com/espers",
        "name": "Espers",
        "official_url": "http://www.espers.org",
        "primary_genre_id": 27,
        "popularity": 0.0,
        "upcoming_events_count": 1,
        "updated_at": "2012-05-31T09:16:49Z",
        "wikipedia_url": "http://en.wikipedia.org/wiki/index.html?curid=4735724",
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/2/15306/1328344246/espers-thumbnail.jpg?1328344246",
          "medium": "http://i1.tc-core.com/artist/2/15306/1328344246/espers-medium.jpg?1328344246",
          "large": "http://i1.tc-core.com/artist/2/15306/1328344246/espers-large.jpg?1328344246",
          "mobile": "http://i1.tc-core.com/artist/2/15306/1328344246/espers-mobile.jpg?1328344246"
        },
        "url": "http://thrillcall.com/artist/Espers"
      },
      {
        ...
      },
      ...
    ]

Metro Area

Fields:

  • city string City of the Metro Area
  • country_code string Country of the Metro Area
  • created_at string ISO 8601 representation the time this object was created
  • id integer Thrillcall ID
  • latitude float Latitude of the Metro Area
  • longitude float Longitude of the Metro Area
  • radius integer Radius of the Metro Area from the Lat/Long center
  • state string State of the Metro Area
  • time_zone string Time zone of the Metro Area
  • updated_at string ISO 8601 representation of last time this object was updated
  • url string URL for this object on Thrillcall
  • offers_availability_status_code integer Offers status for the Metro Area ( no_offers = 0, available = 1, coming_soon = 2)

GET /metro_areas

Params:

Returns: Array of Metro Areas Hash

    // Example: GET /api/v3/metro_areas?limit=14&api_key=1234567890abcdef

    [
      {
        "city": "Chicago",
        "country_code": "US",
        "created_at": "2011-06-24T03:23:57Z",
        "id": 104,
        "latitude": 41.8842,
        "longitude": -87.6324,
        "offers_availability_status_code": 1,
        "radius": 50,
        "state": "IL",
        "time_zone": "America/Chicago",
        "updated_at": "2011-12-27T00:44:37Z",
        "url": "http://thrillcall.com/live-music/chicago"
      },
      {
        ...
      },
      ...
    ]

GET /metro_area/:id

:id integer Thrillcall ID

Params:

  • None

Returns: Metro Area Hash

    // Example: GET /api/v3/metro_area/105?api_key=1234567890abcdef

    {
      "city": "San Francisco",
      "country_code": "US",
      "created_at": "2011-06-24T03:23:57Z",
      "id": 105,
      "latitude": 37.7771,
      "longitude": -122.42,
      "offers_availability_status_code": 1,
      "radius": 50,
      "state": "CA",
      "time_zone": "America/Los_Angeles",
      "updated_at": "2011-12-27T00:44:37Z",
      "url": "http://thrillcall.com/live-music/san-francisco"
    }

GET /metro_area/:id/events

:id integer Thrillcall ID

Params:

Note: Time Zone is set as the time zone of the Metro Area and cannot be overridden.

Returns: Array of Metro Areas Hash

    // Example: GET /api/v3/metro_area/105/events?min_date=2011-06-20&max_date=2012-06-19&limit=3&api_key=1234567890abcdef

    [
      {
        "created_at": "2012-01-02T08:53:00Z",
        "festival": false,
        "id": 1011386,
        "latitude": 37.7771,
        "longitude": -122.42,
        "name": "Kontrol @ The End Up",
        "rumor": false,
        "starts_at": "2012-01-07T08:00:04Z",
        "starts_at_time_trusted": false,
        "unconfirmed_location": 0,
        "updated_at": "2012-03-29T01:19:31Z",
        "venue_id": 47273,
        "photos": {
          "thumbnail": "http://i1.tc-core.com/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-thumbnail.jpg?1326489566",
          "large": "http://i1.tc-core.com/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-large.jpg?1326489566",
          "mobile": "http://i1.tc-core.com/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-mobile.jpg?1326489566"
        },
        "url": "http://thrillcall.com/event/1011386",
        "starts_at_local": "2012-01-07T00:00:04-08:00",
        "time_zone": "America/Los_Angeles",
        "event_status": "confirmed",
        "name_modified": false,
        "featured_event": false,
        "venue": {
          "address2":null,"city":"San Francisco",
          "country_code":"US",
          "created_at":"2008-04-28T18:13:50Z",
          "facebook_url":"http://www.facebook.com/theendup",
          "hide_resale_tickets":false,
          "id":47273,
          "latitude":37.777243,
          "long_description":null,
          "longitude":-122.403919,
          "myspace_url":null,
          "name":"The End Up",
          "official_url":"http://www.theendup.com",
          "phone_number":"+1 (415) 896-1075",
          "state":"CA",
          "time_zone":"America/Los_Angeles",
          "upcoming_events_count":5,
          "updated_at":"2012-08-19T11:29:19Z",
          "postalcode":"94708",
          "photos":{"thumbnail":"http://i1.tc-core.com/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-thumbnail.jpg?1326489566",
          "medium":"http://i1.tc-core.com/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-medium.jpg?1326489566",
          "large":"http://i1.tc-core.com/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-large.jpg?1326489566",
          "mobile":"http://i.development.tc-core.com/noel/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-mobile.jpg?1326489566"},
          "metro_area_id":105,
          "url":"http://localhost:3000/venue/The_End_Up_in_San_Francisco_CA"
        },
        "artists": [
          {
            "id": 2295,
            "name": "Kontrol",
            "headliner": false
          }
        ],
        "offer_details": {}
      },
      {
        ...
      },
      ...
    ]

Person

Note: Your API key requires the api_auth permission to access the endpoints associated with this object.

Fields:

  • created_at string ISO 8601 representation the time this object was created
  • first_name string First name of the Person
  • gender string Gender of the Person
  • id integer Thrillcall ID
  • last_name string Last name of the Person
  • login string Login (Email Address) of the Person
  • updated_at string ISO 8601 representation of last time this object was updated
  • referral_code string Referral code of the Person
  • referral_credits integer Number of Referral credits the Person has (including bonus points)
  • postalcode string Postalcode of the Person
  • photos hash A hash of image urls of the primary photo available for this object in different styles
  • preferred_radius float Preference for radius in miles from the Person to search for events for that Person

GET /person/:id

Params:

  • None

Returns: Person Hash

    // Example: GET /api/v3/person/49?api_key=1234567890abcdef

    {
      "address1": null,
      "address2": null,
      "city": "Santa Rosa",
      "country_code": "US",
      "created_at": "2011-10-17T18:54:31Z",
      "credentials": [
        {
          "id": 18434,
          "provider": "facebook",
          "uid": "abc123",
          "token_present": true
        }
      ]
      "first_name": "John",
      "gender": "m",
      "id": 49,
      "last_name": "Doe",
      "login": "bogus@bogus.com",
      "state": "CA",
      "time_zone": "America/Los_Angeles",
      "timezone": "-7",
      "updated_at": "2012-03-28T16:07:16Z",
      "referral_code": null,
      "referral_credits": 0,
      "postalcode": "95407",
      "photos": {
        "small_thumb": "http://i1.tc-core.com/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
        "thumbnail": "http://i1.tc-core.com/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
        "medium": "http://i1.tc-core.com/person/164761/1324568419/19154-medium.jpg?1324568419"
      },
      "preferred_radius": 100.0
    }

POST /person/signin

Params:

Use either email / password or provider / uid / token.

May perform registration ("signup") automatically if using provider / uid / token when no match is found and name, location, and referral_code are also provided.

Returns: Person Hash

    // Example: POST /api/v3/person/signin?provider=facebook&uid=123123bogus&token=123123bogus&email=123123bogus%40bogus.com&first_name=Mister&last_name=Bogus&lat=38.5&long=-123.0&api_key=1234567890abcdef

    {
      "address1": null,
      "address2": null,
      "city": null,
      "country_code": null,
      "created_at": null,
      "credentials": [
        {
          "id": 18434,
          "provider": "facebook",
          "uid": "abc123",
          "token_present": true
        }
      ]
      "first_name": "Mister",
      "gender": null,
      "last_name": "Bogus",
      "login": null,
      "state": null,
      "time_zone": null,
      "timezone": null,
      "updated_at": null,
      "referral_code": null,
      "referral_credits": 0,
      "postalcode": null,
      "photos": {
        "small_thumb": "http://i1.tc-core.com/person/_default/default-small_thumb.jpg",
        "thumbnail": "http://i1.tc-core.com/person/_default/default-thumbnail.jpg",
        "medium": "http://i1.tc-core.com/person/_default/default-medium.jpg"
      },
      "preferred_radius": 100.0
    }

POST /person/signup

Params:

Returns: Person Hash

    // Example: POST /api/v3/person/signup?first_name=Mister&email=bogus%40bogus.com&password=bogus&postalcode=94108&api_key=1234567890abcdef

    {
      "address1": null,
      "address2": null,
      "city": null,
      "country_code": null,
      "created_at": null,
      "credentials": [
        {
          "id": 18434,
          "provider": "facebook",
          "uid": "abc123",
          "token_present": true
        }
      ]
      "first_name": "Mister",
      "gender": null,
      "last_name": null,
      "login": null,
      "state": null,
      "time_zone": null,
      "timezone": null,
      "updated_at": null,
      "referral_code": null,
      "referral_credits": 0,
      "postalcode": null,
      "photos": {
        "small_thumb": "http://i1.tc-core.com/person/_default/default-small_thumb.jpg",
        "thumbnail": "http://i1.tc-core.com/person/_default/default-thumbnail.jpg",
        "medium": "http://i1.tc-core.com/person/_default/default-medium.jpg"
      },
      "preferred_radius": 100.0
    }

PUT /person/:id

Params:

Returns: Person Hash

    // Example: PUT /api/v3/person/49&first_name=John&api_key=1234567890abcdef

    {
      "address1": null,
      "address2": null,
      "city": "Santa Rosa",
      "country_code": "US",
      "created_at": "2011-10-17T18:54:31Z",
      "credentials": [
        {
          "id": 18434,
          "provider": "facebook",
          "uid": "abc123",
          "token_present": true
        }
      ]
      "first_name": "John",
      "gender": "m",
      "id": 49,
      "last_name": "Doe",
      "login": "bogus@bogus.com",
      "state": "CA",
      "time_zone": "America/Los_Angeles",
      "timezone": "-7",
      "updated_at": "2012-03-28T16:07:16Z",
      "referral_code": null,
      "referral_credits": 0,
      "postalcode": "95407",
      "photos": {
        "small_thumb": "http://i1.tc-core.com/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
        "thumbnail": "http://i1.tc-core.com/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
        "medium": "http://i1.tc-core.com/person/164761/1324568419/19154-medium.jpg?1324568419"
      },
      "preferred_radius": 100.0
    }

GET /people/tracking/:class

:class string One of: "genres", "events", "artists", "people", "venues"

Params:

Returns: Array of Hash containing id, name, and count for each tracked :class ordered by count descending.

    // Example: GET /api/v3/people/tracking/artist?ids=2,4,321&api_key=1234567890abcdef

    [
      {
        "name": "M83",
        "count": 3,
        "id": 18927
      },
      {
        "name": "Radiohead",
        "count": 2,
        "id": 2687
      },
      ...
    ]

GET /person/:id/:class

:class string One of: "genres", "events", "artists", "people", "venues"

Params:

  • None.

Returns: Hash of tracked :class IDs mapped to :class names for this person.

    // Example: GET /api/v3/person/2/artists&api_key=1234567890abcdef

    {
      "2687": "Radiohead",
      "18927": "M83",
      ...
    }

POST /person/:id/:action/:class

:action string One of: "track", "untrack" :class string One of: "genres", "events", "artists", "people", "venues"

Params:

Returns: Hash of :class tracked IDs mapped for this person after performing :action.

    // Example: POST /api/v3/person/24/track/artists?ids=44,45&platform=ios&api_key=1234567890abcdef

    {
      "44": "Paco Osuna",
      "45": "Wanamaker"
    }

POST /person/:id/track_artists_by_name

Params:

Returns: Array of hash with tracked artist IDs mapped to artist names for this person.

    // Example: POST /api/v3/person/24/track_artists_by_name?artist_names=Radiohead,M83&platform=ios&api_key=1234567890abcdef

    [
      {
        "2687": "Radiohead"
      },
      {
        "18927": "M83",
      }
    ]

GET /person/:id/recommended_events

:id integer Thrillcall ID

Params:

Note: By default, this will search for events within the Person's preferred_radius of the Person's geolocation. You may override these defaults with lat/long or postalcode and radius.

Returns: Array of Events Hash where at least one of the person's tracked artists is performing in an event

    // Example: GET /api/v3/person/24/recommended_events?api_key=1234567890abcdef

    [
      {
        "id": 1291050,
        "name": "T.I., Lil Wayne, 2 Chainz @ Sleep Train Pavilion At Concord",
        "venue_id": 323,
        "created_at": "2013-03-25T20:42:16Z",
        "updated_at": "2013-06-12T22:20:41Z",
        "festival": false,
        "rumor": false,
        "unconfirmed_location": 0,
        "latitude": 37.9604,
        "longitude": -121.94,
        "starts_at": "2013-08-31T02:30:00Z",
        "starts_at_time_trusted": true,
        "skip_event_conflict_validation": false,
        "distance": 30.608671818601927,
        "bearing": "68.0",
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/34156/491/1324556348/lil-wayne-thumbnail.jpg?1324556348",
          "large": "http://i1.tc-core.com/artist/34156/491/1324556348/lil-wayne-large.jpg?1324556348",
          "mobile": "http://i1.tc-core.com/artist/34156/491/1324556348/lil-wayne-mobile.jpg?1324556348"
        },
        "url": "http://thrillcall.com/event/1291050",
        "starts_at_local": "2013-08-30T19:30:00-07:00",
        "time_zone": "America/Los_Angeles",
        "event_status": "confirmed",
        "name_modified": false,
        "featured_event": false,
        "venue": {
          "id": 323,
          "name": "Sleep Train Pavilion At Concord",
          "address1": "2000 Kirker Pass Road",
          "address2": null,
          "city": "Concord",
          "state": "CA",
          "official_url": null,
          "created_at": "2008-04-21T16:52:53Z",
          "updated_at": "2013-06-24T09:00:13Z",
          "latitude": 37.960354,
          "longitude": -121.939659,
          "country_code": "US",
          "myspace_url": null,
          "upcoming_events_count": 4,
          "facebook_url": "http://www.facebook.com/pages/Sleep-Train-Pavilion/116238125066831",
          "long_description": null,
          "phone_number": "+1 (925) 676-8742",
          "time_zone": "America/Los_Angeles",
          "hide_resale_tickets": false,
          "postalcode": "94521",
          "photos": {
            "thumbnail": "http://i1.tc-core.com/venue/323/1473/1336436387/sleep-train-pavilion-at-concord-in-concord-ca-thumbnail.jpg?1336436387",
            "medium": "http://i1.tc-core.com/venue/323/1473/1336436387/sleep-train-pavilion-at-concord-in-concord-ca-medium.jpg?1336436387",
            "large": "http://i1.tc-core.com/venue/323/1473/1336436387/sleep-train-pavilion-at-concord-in-concord-ca-large.jpg?1336436387",
            "mobile": "http://i1.tc-core.com/venue/323/1473/1336436387/sleep-train-pavilion-at-concord-in-concord-ca-mobile.jpg?1336436387"
          },
          "metro_area_id": 105,
          "url": "http://thrillcall.com/venue/Sleep_Train_Pavilion_At_Concord_in_Concord_CA"
        },
        "artists": [
          {
            "id": 34156,
            "name": "Lil Wayne",
            "headliner": true
          },
          {
            "id": 28490,
            "name": "T.I.",
            "headliner": false
          },
          {
            "id": 387608,
            "name": "2 Chainz",
            "headliner": false
          }
        ],
        "offer_details": {}
      },
      {
        ...
      },
      ...
    ]

GET /person/:id/discover_events

:id integer Thrillcall ID

Params:

Note: By default, this will search for events within the Person's preferred_radius of the Person's geolocation. You may override these defaults with lat/long or postalcode and radius.

Returns: Array of Events Hash where a similar artist to one of the person's tracked artists is performing in an event

    // Example: GET /api/v3/person/24/discover_events?api_key=1234567890abcdef

    [
      {
        "id": 1308413,
        "name": "My Morning Jacket, Wilco, Bob Dylan, Ryan Bingham @ Shoreline Amphitheatre at Mountain View",
        "venue_id": 29474,
        "created_at": "2013-04-22T20:54:34Z",
        "updated_at": "2013-05-11T03:22:49Z",
        "festival": false,
        "rumor": false,
        "unconfirmed_location": 0,
        "latitude": 37.4234,
        "longitude": -122.078,
        "starts_at": "2013-08-05T00:30:00Z",
        "starts_at_time_trusted": true,
        "skip_event_conflict_validation": false,
        "distance": 30.458803738929397,
        "bearing": "133.0",
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/28246/513/1324556491/bob-dylan-thumbnail.jpg?1324556491",
          "large": "http://i1.tc-core.com/artist/28246/513/1324556491/bob-dylan-large.jpg?1324556491",
          "mobile": "http://i1.tc-core.com/artist/28246/513/1324556491/bob-dylan-mobile.jpg?1324556491"
        },
        "url": "http://thrillcall.com/event/1308413",
        "starts_at_local": "2013-08-04T17:30:00-07:00",
        "time_zone": "America/Los_Angeles",
        "event_status": "confirmed",
        "name_modified": false,
        "featured_event": false,
        "venue": {
          "id": 29474,
          "name": "Shoreline Amphitheatre at Mountain View",
          "address1": "One Amphitheatre Parkway",
          "address2": null,
          "city": "Mountain View",
          "state": "CA",
          "official_url": "http://www.livenation.com/Shoreline-Amphitheatre-tickets-Mountain-View/venue/229414",
          "created_at": "2008-04-21T16:52:54Z",
          "updated_at": "2013-08-04T04:48:04Z",
          "latitude": 37.4234,
          "longitude": -122.078124,
          "country_code": "US",
          "myspace_url": null,
          "upcoming_events_count": 25,
          "facebook_url": "http://www.facebook.com/ShorelineAmphitheatre?sk=info",
          "long_description": null,
          "phone_number": "+1 (650) 967-3000",
          "time_zone": "America/Los_Angeles",
          "hide_resale_tickets": false,
          "postalcode": "94043",
          "photos": {
            "thumbnail": "http://i1.tc-core.com/venue/29474/263/1327616683/shoreline-amphitheatre-at-mountain-view-in-mountain-view-ca-thumbnail.jpg?1327616683",
            "medium": "http://i1.tc-core.com/venue/29474/263/1327616683/shoreline-amphitheatre-at-mountain-view-in-mountain-view-ca-medium.jpg?1327616683",
            "large": "http://i1.tc-core.com/venue/29474/263/1327616683/shoreline-amphitheatre-at-mountain-view-in-mountain-view-ca-large.jpg?1327616683",
            "mobile": "http://i1.tc-core.com/venue/29474/263/1327616683/shoreline-amphitheatre-at-mountain-view-in-mountain-view-ca-mobile.jpg?1327616683"
          },
          "metro_area_id": 141,
          "url": "http://thrillcall.com/venue/Shoreline_Amphitheatre_at_Mountain_View_in_Mountain_View_CA"
        },
        "artists": [
          {
          "id": 28246,
          "name": "Bob Dylan",
          "headliner": true
          },
          {
          "id": 16250,
          "name": "Wilco",
          "headliner": false
          },
          {
          "id": 9271,
          "name": "My Morning Jacket",
          "headliner": false
          },
          {
          "id": 53718,
          "name": "Ryan Bingham",
          "headliner": false
          }
        ],
        "offer_details": {}
      },
      {
        ...
      },
      ...
    ]

GET /person/:id/friends_events

:id integer Thrillcall ID

Params:

  • None.

Returns: Array of Hashes containing Person Hash keyed on "friend" and Array of Event IDs keyed on "events"

All people in the result set are friends (tracked Person objects) of the Person.

Event IDs are future active events tracked by that friend.

    // Example: GET /api/v3/person/2/friends_events&api_key=1234567890abcdef

    [
      {
        "friend": {
          "address1": null,
          "address2": null,
          "city": "Santa Rosa",
          "country_code": "US",
          "created_at": "2011-10-17T18:54:31Z",
          "credentials": [
            {
              "id": 18434,
              "provider": "facebook",
              "uid": "abc123",
              "token_present": true
            }
          ]
          "first_name": "John",
          "gender": "m",
          "id": 49,
          "last_name": "Doe",
          "login": "bogus@bogus.com",
          "state": "CA",
          "time_zone": "America/Los_Angeles",
          "timezone": "-7",
          "updated_at": "2012-03-28T16:07:16Z",
          "referral_code": null,
          "referral_credits": 0,
          "postalcode": "95407",
          "photos": {
            "small_thumb": "http://i1.tc-core.com/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
            "thumbnail": "http://i1.tc-core.com/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
            "medium": "http://i1.tc-core.com/person/164761/1324568419/19154-medium.jpg?1324568419"
          },
          "preferred_radius": 100.0
        },
        "events": [
          1308413,
          ...
        ],
        ...
      }
    ]

Credentials

Fields:

N/A. Always returns Person objects. Credentials are nested inside Person objects.

POST /credential

Params:

Returns: Person Hash

Credentials are stored tokens allowing us to authenticate on behalf of a Person. These are typically OAuth tokens, but can take any form. The token itself is not required and may be left blank, the other parameters are required.

    // Example: POST /api/v3/credential
    // person_id=49&provider=spotify&uid=4321&token=abc123&api_key=1234567890abcdef

    {
      "address1": null,
      "address2": null,
      "city": "Santa Rosa",
      "country_code": "US",
      "created_at": "2011-10-17T18:54:31Z",
      "credentials": [
        {
          "id": 18435,
          "provider": "spotify",
          "uid": "4321",
          "token_present": true
        }
      ]
      "first_name": "John",
      "gender": "m",
      "id": 49,
      "last_name": "Doe",
      "login": "bogus@bogus.com",
      "state": "CA",
      "time_zone": "America/Los_Angeles",
      "timezone": "-7",
      "updated_at": "2012-03-28T16:07:16Z",
      "referral_code": null,
      "referral_credits": 0,
      "postalcode": "95407",
      "photos": {
        "small_thumb": "http://i1.tc-core.com/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
        "thumbnail": "http://i1.tc-core.com/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
        "medium": "http://i1.tc-core.com/person/164761/1324568419/19154-medium.jpg?1324568419"
      },
      "preferred_radius": 100.0
    }

PUT /credential/:id

:id integer Thrillcall ID

Params:

Returns: Person Hash

This endpoint allows you to change the UID or token of an existing credential. You must supply either the user's current password, or the existing token on the credential.

    // Example: PUT /api/v3/credential/18435
    // old_token=abc123&token=&api_key=1234567890abcdef

    {
      "address1": null,
      "address2": null,
      "city": "Santa Rosa",
      "country_code": "US",
      "created_at": "2011-10-17T18:54:31Z",
      "credentials": [
        {
          "id": 18435,
          "provider": "spotify",
          "uid": "4321",
          "token_present": false
        }
      ]
      "first_name": "John",
      "gender": "m",
      "id": 49,
      "last_name": "Doe",
      "login": "bogus@bogus.com",
      "state": "CA",
      "time_zone": "America/Los_Angeles",
      "timezone": "-7",
      "updated_at": "2012-03-28T16:07:16Z",
      "referral_code": null,
      "referral_credits": 0,
      "postalcode": "95407",
      "photos": {
        "small_thumb": "http://i1.tc-core.com/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
        "thumbnail": "http://i1.tc-core.com/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
        "medium": "http://i1.tc-core.com/person/164761/1324568419/19154-medium.jpg?1324568419"
      },
      "preferred_radius": 100.0
    }

Venues

Fields:

  • address1 string First address field for the Venue
  • address2 string Second address field for the Venue
  • city string City the Venue is in
  • country_code string Country the Venue is in
  • created_at string ISO 8601 representation the time this object was created
  • id integer Thrillcall ID
  • latitude float Approximate Latitude for the Venue
  • long_description text Description of the Venue
  • longitude float Approximate Longitude for the Venue
  • name string Name of the Venue
  • metro_area_id integer Thrillcall ID of the Metro Area this Venue is in, if any
  • state string State the Venue is in
  • upcoming_events_count integer Number of upcoming events associated with this object
  • updated_at string ISO 8601 representation of last time this object was updated
  • postalcode string Postal code for the Venue
  • phone_number string Phone number for the Venue (including country code)
  • photos hash A hash of image urls of the primary photo available for this object in different styles
  • url string URL for this object on Thrillcall

GET /venues

Params:

Returns: Array of Venues Hash

    // Example: GET /api/v3/venues?limit=14&api_key=1234567890abcdef

    [
      {
        "address1": null,
        "address2": null,
        "city": "Guadalajara",
        "country_code": "MX",
        "created_at": "2008-05-09T09:29:23Z",
        "facebook_url": null,
        "hide_resale_tickets": false,
        "id": 1,
        "latitude": 20.666222,
        "long_description": null,
        "longitude": -103.352089,
        "myspace_url": null,
        "name": "Fbolko",
        "official_url": null,
        "phone_number": null,
        "state": null,
        "time_zone": "America/Mexico_City",
        "upcoming_events_count": 0,
        "updated_at": "2012-04-20T19:08:53Z",
        "postalcode": "0",
        "photos": {
          "thumbnail": "http://i1.tc-core.com/venue/_default/default-thumbnail.jpg",
          "medium": "http://i1.tc-core.com/venue/_default/default-medium.jpg",
          "large": "http://i1.tc-core.com/venue/_default/default-large.jpg",
          "mobile": "http://i1.tc-core.com/venue/_default/default-mobile.jpg"
        },
        "metro_area_id": null,
        "url": "http://thrillcall.com/venue/Fbolko_in_Guadalajara"
      },
      {
        ...
      },
      ...
    ]

POST /venue

Params:

Returns: Venue Hash

    // Example: POST /api/v3/venue?name=Test%20Venue&city=Guerneville&state=CA&country_code=US&address1=123%20Main%20St&postalcode=95446&api_key=1234567890abcdef

    {
      "address1": "123 Main St",
      "address2": null,
      "city": "Guerneville",
      "country_code": "US",
      "created_at": "2012-08-14T00:15:23Z",
      "facebook_url": null,
      "hide_resale_tickets": false,
      "id": 108951,
      "latitude": 38.50223159790039,
      "long_description": null,
      "longitude": -122.99627685546875,
      "myspace_url": null,
      "name": "Test Venue",
      "official_url": null,
      "phone_number": null,
      "state": "CA",
      "time_zone": "America/Los_Angeles",
      "upcoming_events_count": 0,
      "updated_at": "2012-08-14T00:15:23Z",
      "postalcode": "95446",
      "photos": {
        "thumbnail": "http://i1.tc-core.com/venue/_default/default-thumbnail.jpg",
        "medium": "http://i1.tc-core.com/venue/_default/default-medium.jpg",
        "large": "http://i1.tc-core.com/venue/_default/default-large.jpg",
        "mobile": "http://i1.tc-core.com/venue/_default/default-mobile.jpg"
      },
      "metro_area_id": null,
      "url": "http://thrillcall.com/venue/Test_Venue_in_Guerneville_CA"
    }

GET /venue/:id

:id integer Thrillcall or Mapping

Params:

  • None

Returns: Venue Hash

    // Example: GET /api/v3/venue/51886?api_key=1234567890abcdef

    {
      "address1": "201 Van Ness Avenue",
      "address2": null,
      "city": "San Francisco",
      "country_code": "US",
      "created_at": "2008-04-28T17:59:32Z",
      "facebook_url": "http://www.facebook.com/sfsymphony",
      "hide_resale_tickets": false,
      "id": 51886,
      "latitude": 37.777402,
      "long_description": null,
      "longitude": -122.419815,
      "myspace_url": null,
      "name": "Davies Symphony Hall",
      "official_url": "http://www.sfsymphony.org/",
      "phone_number": "+1 (415) 864-6000",
      "state": "CA",
      "time_zone": "America/Los_Angeles",
      "upcoming_events_count": 17,
      "updated_at": "2012-07-03T09:37:30Z",
      "postalcode": "94102",
      "photos": {
        "thumbnail": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-thumbnail.jpg?1326417154",
        "medium": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-medium.jpg?1326417154",
        "large": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-large.jpg?1326417154",
        "mobile": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-mobile.jpg?1326417154"
      },
      "metro_area_id": 105,
      "url": "http://thrillcall.com/venue/Davies_Symphony_Hall_in_San_Francisco_CA"
    }

PUT /venue/:id

Params:

Returns: Venue Hash

    // Example: PUT /api/v3/venue/51886?address1=202%20Van%20Ness%20Avenue&api_key=1234567890abcdef

    {
      "address1": "202 Van Ness Avenue",
      "address2": null,
      "city": "San Francisco",
      "country_code": "US",
      "created_at": "2008-04-28T17:59:32Z",
      "facebook_url": "http://www.facebook.com/sfsymphony",
      "hide_resale_tickets": false,
      "id": 51886,
      "latitude": 37.777402,
      "long_description": null,
      "longitude": -122.419815,
      "myspace_url": null,
      "name": "Davies Symphony Hall",
      "official_url": "http://www.sfsymphony.org/",
      "phone_number": "+1 (415) 864-6000",
      "state": "CA",
      "time_zone": "America/Los_Angeles",
      "upcoming_events_count": 17,
      "updated_at": "2012-07-03T09:37:30Z",
      "postalcode": "94102",
      "photos": {
        "thumbnail": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-thumbnail.jpg?1326417154",
        "medium": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-medium.jpg?1326417154",
        "large": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-large.jpg?1326417154",
        "mobile": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-mobile.jpg?1326417154"
      },
      "metro_area_id": 105,
      "url": "http://thrillcall.com/venue/Davies_Symphony_Hall_in_San_Francisco_CA"
    }

GET /venue/:id/events

:id integer Thrillcall or Mapping

Params:

Returns: Array of Events Hash

    // Example: GET /api/v3/venue/63279/events?api_key=1234567890abcdef

    [
      {
        "created_at": "2012-03-02T18:06:14Z",
        "festival": false,
        "id": 1047075,
        "latitude": 37.7915,
        "longitude": -122.413,
        "name": "Il Volo @ Masonic Center",
        "rumor": false,
        "starts_at": "2012-09-30T02:30:04Z",
        "starts_at_time_trusted": true,
        "unconfirmed_location": 0,
        "updated_at": "2012-03-29T01:35:57Z",
        "venue_id": 63279,
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
          "large": "http://i1.tc-core.com/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
          "mobile": "http://i1.tc-core.com/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
        },
        "url": "http://thrillcall.com/event/1047075",
        "starts_at_local": "2012-09-29T19:30:04-07:00",
        "time_zone": "America/Los_Angeles",
        "event_status": "confirmed",
        "name_modified": false,
        "featured_event": false,
        "venue": {
          "address1": "1111 California Street",
          "address2": null,
          "city": "San Francisco",
          "country_code": "US",
          "created_at": "2009-08-25T19:25:27Z",
          "facebook_url": "http://www.facebook.com/pages/Nob-Hill-Masonic-Center/152483968103491",
          "hide_resale_tickets": false,
          "id": 63279,
          "latitude": 37.79153,
          "long_description": null,
          "longitude": -122.412757,
          "myspace_url": "http://www.myspace.com/masonicauditorium",
          "name": "Masonic Center",
          "official_url": "http://www.masonicauditorium.com/",
          "phone_number": "+1 (877) 598-8497",
          "state": "CA",
          "time_zone": "America/Los_Angeles",
          "upcoming_events_count": 10,
          "updated_at": "2012-07-03T09:41:24Z",
          "postalcode": "94108",
          "photos": {
            "thumbnail": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135",
            "medium": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135",
            "large": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135",
            "mobile": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"
          },
          "metro_area_id": 105,
          "url": "http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"
        },
        "artists": [
          {
            "id": 378465,
            "name": "Il Volo",
            "headliner": false
          }
        ],
        "offer_details": {}
      },
      {
        ...
      },
      ...
    ]

GET /search/venues/:term

:term string Arbitrary search string on the name field. (alphanumerics only, underscore matches underscore, use '+' for space)

Params:

Returns: Array of Venues Hash

    // Example: GET /api/v3/search/venues/Masonic%20Center?api_key=1234567890abcdef

    [
      {
        "address1": "525 W Riverview Ave",
        "address2": null,
        "city": "Dayton",
        "country_code": "US",
        "created_at": "2008-06-12T14:12:53Z",
        "facebook_url": null,
        "hide_resale_tickets": false,
        "id": 33642,
        "latitude": 39.765526,
        "long_description": null,
        "longitude": -84.203133,
        "myspace_url": null,
        "name": "Dayton Masonic Center",
        "official_url": null,
        "phone_number": null,
        "state": "OH",
        "time_zone": "America/New_York",
        "upcoming_events_count": 0,
        "updated_at": "2012-06-06T03:05:53Z",
        "postalcode": "45405",
        "photos": {
          "thumbnail": "http://i1.tc-core.com/venue/_default/default-thumbnail.jpg",
          "medium": "http://i1.tc-core.com/venue/_default/default-medium.jpg",
          "large": "http://i1.tc-core.com/venue/_default/default-large.jpg",
          "mobile": "http://i1.tc-core.com/venue/_default/default-mobile.jpg"
        },
        "metro_area_id": 134,
        "url": "http://thrillcall.com/venue/Dayton_Masonic_Center_in_Dayton_OH"
      },
      {
        ...
      },
      ...
    ]

Tickets

Fields:

  • created_at string ISO 8601 representation the time this object was created
  • currency string Currency of the price
  • description string Long form description of the ticket
  • event_id integer Thrillcall Event ID
  • id integer Thrillcall ID
  • marketing_text string Long form description of the ticket
  • max_ticket_price string Maximum price for this ticket
  • min_ticket_price string Minimum price for this ticket
  • name string Name of this ticket
  • on_sale_end_date string YYYY-MM-DD date when the ticket goes off sale
  • on_sale_start_date string YYYY-MM-DD date when the ticket goes on sale
  • seat_info string Additional info about the seat
  • updated_at string ISO 8601 representation of last time this object was updated
  • url string URL for this object on Thrillcall

GET /tickets

Params:

Returns: Array of Tickets Hash

    // Example: GET /api/v3/tickets?limit=14&api_key=1234567890abcdef

    [
      {
        "created_at": "2008-12-06T00:19:59Z",
        "currency": "USD",
        "description": null,
        "event_id": 455646,
        "id": 1,
        "marketing_text": null,
        "max_ticket_price": "0.00",
        "min_ticket_price": "0.00",
        "name": "General Onsale",
        "on_sale_end_date": null,
        "on_sale_start_date": null,
        "seat_info": null,
        "updated_at": "2009-09-22T22:58:37Z",
        "url": "http://www.livenation.com/edp/eventId/335800/?c=api-000157"
      },
      {
        ...
      },
      ...
    ]

GET /ticket/:id

:id integer Thrillcall ID

Params:

  • None

Returns: Ticket Hash

    // Example: GET /api/v3/ticket/819883?api_key=1234567890abcdef

    {
      "created_at": "2012-03-02T18:06:14Z",
      "currency": "USD",
      "description": null,
      "event_id": 1047075,
      "id": 819883,
      "marketing_text": null,
      "max_ticket_price": "85.00",
      "min_ticket_price": "29.00",
      "name": "Onsale to General Public",
      "on_sale_end_date": null,
      "on_sale_start_date": null,
      "seat_info": null,
      "updated_at": "2012-03-02T18:06:14Z",
      "url": "http://ticketsus.at/thrillcall?CTY=39&DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&brand=[=BRAND=]"
    }

Mappings

Mappings provide a translation between a Thrillcall ID and an ID from another source (partner).

They are used in place of IDs in the following format:

  partner_name:obj_type:partner_id

For example:

  GET /artist/myspace:artist:alicia_keys

Fields:

  • created_at string ISO 8601 representation the time this object was created
  • id integer Thrillcall ID of the mapping, not the referenced object
  • obj_type integer Type of the referenced object, e.g. "artist"
  • partner_display_name string The name of the object according to the partner, if different
  • partner_id string The name of the partner for this foreign mapping, e.g. "myspace"
  • partner_obj_id string Partner's ID for the referenced object
  • tc_obj_id integer Thrillcall ID of the referenced object
  • updated_at string ISO 8601 representation of last time this object was updated

GET /mappings

Params:

Returns: Array of Mappings Hash

  // Example: GET /mappings?api_key=1234567890abcdef

  [
    {
      "created_at": "2009-08-13T01:51:23Z",
      "id": 1,
      "obj_type": "artist",
      "partner_display_name": "3",
      "partner_id": "livenation",
      "partner_obj_id": "448380",
      "tc_obj_id": 17498,
      "updated_at": "2012-07-18T00:10:15Z"
    },
    {
      ...
    },
    ...
  ]

GET /mapping/:id

:id integer Thrillcall ID

Params:

  • None

Returns: Mapping Hash

  // Example: GET /mapping/1?api_key=1234567890abcdef

  {
    "created_at": "2009-08-13T01:51:23Z",
    "id": 1,
    "obj_type": "artist",
    "partner_display_name": "3",
    "partner_id": "livenation",
    "partner_obj_id": "448380",
    "tc_obj_id": 17498,
    "updated_at": "2012-07-18T00:10:15Z"
  }

POST /mapping

Create a new foreign ID mapping

Params:

  • obj_type integer Type of the referenced object, e.g. "artist"
  • partner_display_name string The name of the object according to the partner, if different
  • partner_id string The name of the partner for this foreign mapping, e.g. "myspace"
  • partner_obj_id string Partner's ID for the referenced object
  • tc_obj_id integer Thrillcall ID of the referenced object

Returns: Mapping Hash

  // Example: POST /mapping?obj_type=artist&partner_id=myspace&partner_obj_id=1&tc_obj_id=2000&api_key=1234567890abcdef

  {
    "created_at": "2009-08-13T01:51:23Z",
    "id": 39821,
    "obj_type": "artist",
    "partner_display_name": null,
    "partner_id": "myspace",
    "partner_obj_id": "1",
    "tc_obj_id": 2000,
    "updated_at": "2012-07-18T00:10:15Z"
  }

PUT /mapping/:id

:id integer Thrillcall ID

Edit an existing foreign ID mapping.

Params:

  • obj_type integer Type of the referenced object, e.g. "artist"
  • partner_display_name string The name of the object according to the partner, if different
  • partner_id string The name of the partner for this foreign mapping, e.g. "myspace"
  • partner_obj_id string Partner's ID for the referenced object
  • tc_obj_id integer Thrillcall ID of the referenced object

Returns: Mapping Hash

  // Example: PUT /mapping/1?partner_obj_id=1000&api_key=1234567890abcdef

  {
    "created_at": "2009-08-13T01:51:23Z",
    "id": 39821,
    "obj_type": "artist",
    "partner_display_name": null,
    "partner_id": "myspace",
    "partner_obj_id": "1000",
    "tc_obj_id": 2000,
    "updated_at": "2012-07-18T00:10:15Z"
  }
Something went wrong with that request. Please try again.