id string

The unique identifier of the event.

E.g. eBZarD9oGNea

title string

The title of the event.

E.g. Katy Perry with Carly Rae Jepsen

description string

A description of the event.

E.g. Katy Perry and Carly Rae Jepsen performing their hit songs at Gila River Arena

start string

The start date of the event in ISO 8601 format.

All start dates are in UTC if the event time zone is provided, and in local time otherwise. For example, Independence Day falls on the 4th of July regardless of the time zone, and will have a blank time zone.

If an event has a start time of midnight (in the event time zone) this is an indication that the actual time may be unknown. You may wish to omit the time when displaying these events.

E.g. 2018-01-20T02:30:00Z

end string

The end date of the event in ISO 8601 format.

All end dates are in UTC if the event time zone is provided, and in local time otherwise. For example, Independence Day falls on the 4th of July regardless of the time zone, and will have a blank time zone.

E.g. 2018-01-20T04:30:00Z

predicted_end string

The predicted end date of the event in ISO 8601 format.

Predicted end dates are in UTC if the event time zone is provided, and in local time otherwise. For example, Independence Day falls on the 4th of July regardless of the time zone, and will have a blank time zone.

This field will be blank when an actual end date is available for an event.

E.g. 2018-01-20T04:30:00Z

duration number

The duration of the event in seconds.

E.g. 7200

labels string

The labels associated with the event. Use the count endpoint to fetch a list of available labels.

E.g. "concerts,music"

category string

The category of the event

Possible values:

• school-holidays
• public-holidays
• observances
• politics
• conferences
• expos
• concerts
• festivals
• performing-arts
• sports
• community
• daylight-savings
• airport-delays
• severe-weather
• disasters
• terror
• health-warnings

E.g. concerts

timezone string

The time zone of the event in TZ Database format. This is helpful so you know which time zone to convert the dates to (if needed).

If the time zone is blank, the start and end date should be regarded as time zone agnostic and already being in local time. Our start and end filters take this into account when specifying a lower and higher bound on dates.

E.g. America/Phoenix

country string

The country code in ISO 3166-1 alpha 2 format.

E.g. US

location string

Latitude and longitude of the event in the order "lat,lon".

E.g. "33.531937,-112.261187"

venue_name string

The name of the venue where the event is happening.

E.g. Gila River Arena

venue_formatted_address string

The address of the venue where the event is happening. Note the address will usually be on multiple lines.

E.g. 9400 West Maryland Avenue↵Glendale, AZ 85305↵United States of America

scope string

The geographical scope the events apply to.

Possible values:

• locality
• county
• region
• country

E.g. locality

rank number

PHQ Rank. A log scale numerical value between 0 and 100 with a five-level hierarchical impact schema. It is designed to represent the potential impact of an event independent of its geographical location.

E.g. 75

local_rank number

Similar to PHQ Rank, this is a log scale numerical value between 0 and 100 with a five-level hierarchical impact schema. It is designed to represent the potential impact of an event on its local geographical area.

Local Rank is calculated for events in the categories community, concerts, conferences, expos, sports, festivals, performing-arts.

If local_rank is not intended to be available for an event, this field will be blank.

E.g. 97

aviation_rank number

A log scale numerical value between 0 and 100 with a five-level hierarchical impact schema. Aviation Rank indicates how much an event will impact flight bookings by considering both domestic and international travel. It can be mapped to the predicted increase in demand based on people flying to an event. Therefore, events with higher Aviation Rank are expected to result in more people taking flights than lower Aviation Rank events.

Aviation Rank is calculated for events in the categories concerts, conferences, expos, sports, festivals, performing-arts, observances, public-holidays, and school-holidays.

If aviation_rank is not intended to be available for an event or we couldn't calculate it, this field will be blank.

E.g. 85

phq_attendance number

A numerical value that reflects the predicted attendance number.

E.g. 2511

state string

The publication state of the event.

Possible values:

• active: the event is published and valid.
• deleted: the event was removed, either because it was cancelled or is a duplicate.

deleted_reason string

The reason why the event was deleted.

Note that this field is only present for events with state deleted.

Possible values:

• cancelled
• duplicate
• invalid
• postponed

E.g. duplicate

first_seen string

The date the event first entered our dataset in ISO 8601 format. All dates are in UTC. This value may be blank on some events, and should not be considered an event announcement date.

E.g. 2017-05-16T18:01:32Z