Events / Index

NameEvents / Index
DescriptionObtain a list of Events that match given conditions.
TypeGET
URL/v9/events
Credential TypeAPI|User
Supports PaginationYes

Long Description

Possible Event States 
The possible event states are shownpostponed, and canceled.

TBD Events 
TBD Events will be returned with an occurs_at of 00:00:00.


Note: You should not use the list method with a name parameter to search events as that will perform an exact match search. To search events first use the /search endpoint to search against your string and then list events using a performer_id or venue_id selected from your /search results.

NOTE: For events in the Sandbox the seating chart URLs that contain media.sandbox.ticketevolution.com may not work. Simply changing that URL portion to media.ticketevolution.com should show a usable seating chart.

Parameters

Name
Description
Type
Presence
LocationConditionals
venue_idVenue at which the event occursIntegerOptionalQueryNo
nameExact name of the event. Use Events / Search when searching for events by name.StringOptionalQueryNo
occurs_at

Refine dates at which the event occurs using an ISO 8601 formatted datetime.

You can use occurs_at twice when using conditionals to retrieve events within a date range. For example, to retrieve only events within April 2018 use occurs_at.gte=2018-04-01&occurs_at.lt=2018-05-01

Date (ISO_8601)OptionalQueryYes
updated_atRefine dates at which the event was updated using an ISO 8601 formatted datetimeDate (ISO_8601)OptionalQueryYes
popularity_scoreRefine long term popularity scoreDecimalOptionalQueryNo
short_term_popularity_scoreRefine short term popularity scoreDecimalOptionalQueryNo
office_idShow only events for which this office has ticketsIntegerOptionalQueryNo
performer_idShow only events at which this performer will performIntegerOptionalQueryNo
primary_performer

If primary_performer is true only events where  performer_id is the Primary performer for the event will be returned.

If primary_performer is false only events where  performer_id is the NOT the Primary performer for the event will be returned.

BooleanOptionalQueryNo
category_idShow only events in this category (does not include sub-categories)IntegerOptionalQueryNo
category_tree

When true and used in conjunction with category_id events in sub-categories of the category_id will be included.

BooleanOptionalQueryNo
qFull-text search eventsStringOptionalQuery

No

fuzzyWhen true and used in conjunction with q will result in fuzzy full text search. Will NOT work if passed without q.BooleanOptionQueryNo
latLatitude & longitude for geolocated searches. Control size of geolocation area using within. Must supply both.DecimalOptionalQueryNo
lon
ipInfer lat and lon by location of IP address for geolocated searches.StringOptionalQueryNo
postal_codeInfer lat and lon by location of postal code for geolocated searches. Control size of geolocation area using within.StringOptionalQueryNo
city_state

Infer lat and lon by location of city and state for geolocated searches. Control size of geolocation area using within.

StringOptionalQueryNo
withinRadius in miles for geolocated searches (default 15)DecimalOptionalQueryNo
only_with_ticketsShow only events that have inventory regardless of whether they are available for sale (All states will be shown). If you want only available tickets, use only_with_available_ticketsString [all | etickets]OptionalQueryNo
by_timeShow only events whose start time is during the day (between 4 AM-4 PM) or night (otherwise)String [day | night]OptionalQueryNo
only_with_available_ticketsShow only events that have available tickets (tickets for sale). Pass with office_id for inventory belonging only to your office. BooleanOptionalQueryNo
order_byPass in the parameter that you want to order by and the sorting order (Ex. :order_by => "events.popularity_score DESC")String

Optional

QueryNo
min_and_max_price
Results will include avg_price, sum_price, median_price, min_price & max_price, calculated based on that Credential’s settingsBoolean Optional QueryNo


Examples

RequestResponse
/v9/events?city_state=jersey%20city,nj&within=2



{
   "current_page":1,
   "events":[
      {
         "products_eticket_count":0,
         "updated_at":"2013-02-19T22:29:13Z",
         "products_count":18,
         "owned_by_office":false,
         "long_term_popularity_score":0.44967,
         "venue":{
            "url":"/venues/6262",
            "name":"Liberty National Golf Club",
            "id":6262,
            "location":"Jersey City, NJ"
         },
         "configuration":{
            "fanvenues_key":null,
            "ticket_utils_id":null,
            "url":"/configurations/13110",
            "name":"General Admission",
            "id":13110,
            "seating_chart":{
               "medium":"https://s3.amazonaws.com/media.ticketevolution.com/configurations/default_maps/ga_500.jpg",
               "large":"https://s3.amazonaws.com/media.ticketevolution.com/configurations/default_maps/ga_1000.jpg"
            }
         },
         "popularity_score":"0",
         "category":{
            "url":"/categories/131",
            "id":"131",
            "parent":{
               "url":"/categories/24",
               "id":"24",
               "parent":{
                  "url":"/categories/1",
                  "id":"1",
                  "parent":null,
                  "name":"Sports"
               },
               "name":"Golf"
            },
            "name":"PGA"
         },
         "state":"shown",
         "url":"/events/376250",
         "name":"2013 Barclays Golf",
         "notes":null,
         "occurs_at":"2013-08-23T08:00:00Z",
         "id":376250,
         "performances":[
            {
               "performer":{
                  "url":"/performers/25395",
                  "name":"The Barclays Golf",
                  "id":25395
               },
               "primary":true
            }
         ]
      },
      {
         "products_eticket_count":0,
         "updated_at":"2013-02-19T22:29:13Z",
         "products_count":33,
         "owned_by_office":false,
         "long_term_popularity_score":0.43603,
         "venue":{
            "url":"/venues/6262",
            "name":"Liberty National Golf Club",
            "id":6262,
            "location":"Jersey City, NJ"
         },
         "configuration":{
            "fanvenues_key":null,
            "ticket_utils_id":null,
            "url":"/configurations/13110",
            "name":"General Admission",
            "id":13110,
            "seating_chart":{
               "medium":"https://s3.amazonaws.com/media.ticketevolution.com/configurations/default_maps/ga_500.jpg",
               "large":"https://s3.amazonaws.com/media.ticketevolution.com/configurations/default_maps/ga_1000.jpg"
            }
         },
         "popularity_score":"0",
         "category":{
            "url":"/categories/131",
            "id":"131",
            "parent":{
               "url":"/categories/24",
               "id":"24",
               "parent":{
                  "url":"/categories/1",
                  "id":"1",
                  "parent":null,
                  "name":"Sports"
               },
               "name":"Golf"
            },
            "name":"PGA"
         },
         "state":"shown",
         "url":"/events/376251",
         "name":"2013 Barclays Golf",
         "notes":null,
         "occurs_at":"2013-08-20T08:00:00Z",
         "id":376251,
         "performances":[
            {
               "performer":{
                  "url":"/performers/25395",
                  "name":"The Barclays Golf",
                  "id":25395
               },
               "primary":true
            }
         ]
      },
      {
         "products_eticket_count":0,
         "updated_at":"2013-02-19T22:29:13Z",
         "products_count":24,
         "owned_by_office":false,
         "long_term_popularity_score":0.4587,
         "venue":{
            "url":"/venues/6262",
            "name":"Liberty National Golf Club",
            "id":6262,
            "location":"Jersey City, NJ"
         },
         "configuration":{
            "fanvenues_key":null,
            "ticket_utils_id":null,
            "url":"/configurations/13110",
            "name":"General Admission",
            "id":13110,
            "seating_chart":{
               "medium":"https://s3.amazonaws.com/media.ticketevolution.com/configurations/default_maps/ga_500.jpg",
               "large":"https://s3.amazonaws.com/media.ticketevolution.com/configurations/default_maps/ga_1000.jpg"
            }
         },
         "popularity_score":"0",
         "category":{
            "url":"/categories/131",
            "id":"131",
            "parent":{
               "url":"/categories/24",
               "id":"24",
               "parent":{
                  "url":"/categories/1",
                  "id":"1",
                  "parent":null,
                  "name":"Sports"
               },
               "name":"Golf"
            },
            "name":"PGA"
         },
         "state":"shown",
         "url":"/events/376252",
         "name":"2013 Barclays Golf",
         "notes":null,
         "occurs_at":"2013-08-24T08:00:00Z",
         "id":376252,
         "performances":[
            {
               "performer":{
                  "url":"/performers/25395",
                  "name":"The Barclays Golf",
                  "id":25395
               },
               "primary":true
            }
         ]
      },
      {
         "products_eticket_count":0,
         "updated_at":"2013-02-19T22:29:13Z",
         "products_count":24,
         "owned_by_office":false,
         "long_term_popularity_score":0.45029,
         "venue":{
            "url":"/venues/6262",
            "name":"Liberty National Golf Club",
            "id":6262,
            "location":"Jersey City, NJ"
         },
         "configuration":{
            "fanvenues_key":null,
            "ticket_utils_id":null,
            "url":"/configurations/13110",
            "name":"General Admission",
            "id":13110,
            "seating_chart":{
               "medium":"https://s3.amazonaws.com/media.ticketevolution.com/configurations/default_maps/ga_500.jpg",
               "large":"https://s3.amazonaws.com/media.ticketevolution.com/configurations/default_maps/ga_1000.jpg"
            }
         },
         "popularity_score":"0",
         "category":{
            "url":"/categories/131",
            "id":"131",
            "parent":{
               "url":"/categories/24",
               "id":"24",
               "parent":{
                  "url":"/categories/1",
                  "id":"1",
                  "parent":null,
                  "name":"Sports"
               },
               "name":"Golf"
            },
            "name":"PGA"
         },
         "state":"shown",
         "url":"/events/376253",
         "name":"2013 Barclays Golf",
         "notes":null,
         "occurs_at":"2013-08-25T08:00:00Z",
         "id":376253,
         "performances":[
            {
               "performer":{
                  "url":"/performers/25395",
                  "name":"The Barclays Golf",
                  "id":25395
               },
               "primary":true
            }
         ]
      },
      {
         "products_eticket_count":0,
         "updated_at":"2013-02-19T22:29:13Z",
         "products_count":24,
         "owned_by_office":false,
         "long_term_popularity_score":0.45202,
         "venue":{
            "url":"/venues/6262",
            "name":"Liberty National Golf Club",
            "id":6262,
            "location":"Jersey City, NJ"
         },
         "configuration":{
            "fanvenues_key":null,
            "ticket_utils_id":null,
            "url":"/configurations/13110",
            "name":"General Admission",
            "id":13110,
            "seating_chart":{
               "medium":"https://s3.amazonaws.com/media.ticketevolution.com/configurations/default_maps/ga_500.jpg",
               "large":"https://s3.amazonaws.com/media.ticketevolution.com/configurations/default_maps/ga_1000.jpg"
            }
         },
         "popularity_score":"15.08",
         "category":{
            "url":"/categories/131",
            "id":"131",
            "parent":{
               "url":"/categories/24",
               "id":"24",
               "parent":{
                  "url":"/categories/1",
                  "id":"1",
                  "parent":null,
                  "name":"Sports"
               },
               "name":"Golf"
            },
            "name":"PGA"
         },
         "state":"shown",
         "url":"/events/376254",
         "name":"2013 Barclays Golf",
         "notes":null,
         "occurs_at":"2013-08-22T08:00:00Z",
         "id":376254,
         "performances":[
            {
               "performer":{
                  "url":"/performers/25395",
                  "name":"The Barclays Golf",
                  "id":25395
               },
               "primary":true
            }
         ]
      },
      {
         "products_eticket_count":0,
         "updated_at":"2013-02-19T22:29:13Z",
         "products_count":24,
         "owned_by_office":false,
         "long_term_popularity_score":0.42858,
         "venue":{
            "url":"/venues/6262",
            "name":"Liberty National Golf Club",
            "id":6262,
            "location":"Jersey City, NJ"
         },
         "configuration":{
            "fanvenues_key":null,
            "ticket_utils_id":null,
            "url":"/configurations/13110",
            "name":"General Admission",
            "id":13110,
            "seating_chart":{
               "medium":"https://s3.amazonaws.com/media.ticketevolution.com/configurations/default_maps/ga_500.jpg",
               "large":"https://s3.amazonaws.com/media.ticketevolution.com/configurations/default_maps/ga_1000.jpg"
            }
         },
         "popularity_score":"0",
         "category":{
            "url":"/categories/131",
            "id":"131",
            "parent":{
               "url":"/categories/24",
               "id":"24",
               "parent":{
                  "url":"/categories/1",
                  "id":"1",
                  "parent":null,
                  "name":"Sports"
               },
               "name":"Golf"
            },
            "name":"PGA"
         },
         "state":"shown",
         "url":"/events/376255",
         "name":"2013 Barclays Golf",
         "notes":null,
         "occurs_at":"2013-08-21T08:00:00Z",
         "id":376255,
         "performances":[
            {
               "performer":{
                  "url":"/performers/25395",
                  "name":"The Barclays Golf",
                  "id":25395
               },
               "primary":true
            }
         ]
      }
   ],
   "per_page":100,
   "total_entries":6
}