Events / Show

Name	Events / Show
Description	Display details about a specified Event.
Type	GET
URL	/v9/events/:event_id
Credential Type	API\|User
Supports Pagination	N/A

Long Description

Display details about a specified Event.

NOTE: The seating_chart image URLs within the configuration object are deprecated and no longer updated. Instead, you should use our dynamic seating charts.

Parameters

Name	Description	Type	Presence	Location

Name	Description	Type	Presence	Location
`event_id`	The ID of the specific Event	Integer	Required	URI

Properties

Property	Description	Type

Property	Description	Type
`category`	The Category of the event	Object
`configuration`	The Configuration of the Venue for the event	Object
`id`	The ID of the Event	Integer
`long_term_popularity_score`	A general scoring of the popularity of this event over time	Decimal
`name`	The name of the event	String
`notes`	Notes regarding the event. These should be shown to the customer as they may include important information such as requirements for entry.	String\|null
`occurs_at`	The date and time of the event in the time zone where the vent takes place. Events with a TBA time will have `00:00:00` for the time. The `occurs_at` property to indicate when an event takes place currently indicates that the time is in UTC/Zulu by using the trailing `Z` time zone indicator even though the `occurs_at` time is actually in the local time. Strip the time zone indicator and do not attempt to do any time zone adjustment when using `occurs_at`.	String
`occurs_at_local`	The date and time of the event with the proper time zone offset.	String
`performances`	An array of the Performers which are scheduled to appear at the event. One of the Performers will have `primary` set to `true` and that performer is the home team or headliner.	Array
`popularity_score`	A general scoring of the popularity of this event	Decimal
`promotion_label`	Text that identifies any sort of special promotion for the event such as “Randy Johnson Bobblehead Night”	String\|null
`requirements`	An object indicating legal requirements for displaying certain ticket information in the location in which the event is being held. If `face_value_display` is `true` then the `face_value` of the ticket groups is required to be shown to the customer before purchasing. If `inclusive_pricing` is `true` then it is not allowable to charge a service fee on the tickets and `retail_price_inclusive` should be displayed to the customer as it will include the proper service fee that you have configured. If `seat_number_display` is `true` then it is required to show seat numbers to the customer before purchasing.	Object
`state`	The status of the event. `shown` is the default `ignored` means the Event is not for sale `postponed` means the Event has been postponed and the `occurs_at` is the new date.	String
`updated_at`	Timestamp of when this Event was last updated.	String
`url`	The relative API URL of the Event	String
`venue`	The Venue at which the Event takes place	Object

Deprecated Properties

The response includes some legacy properties that should be ignored including

available_count (Use Events / Stats to get accurate ticket group information)
configuration.seating_chart
meta
owned_by_office
products_count (Use Events / Stats to get accurate ticket group information)
products_eticket_count (Use Events / Stats to get accurate ticket group information)
stubhub_id

Examples

Request	Response

Request

Response

GET /v9/events/2585673

{
  "category": {
    "id": "57",
    "name": "Rock & Pop",
    "parent": {
      "id": "54",
      "name": "Concerts",
      "parent": null,
      "slug": "concerts",
      "slug_url": "/categories/concerts",
      "url": "/categories/54"
    },
    "slug": "rock-pop",
    "slug_url": "/categories/rock-pop",
    "url": "/categories/57"
  },
  "configuration": {
    "id": 17891,
    "name": "General Admission",
    "url": "/configurations/17891"
  },
  "id": 2585673,
  "long_term_popularity_score": 0.1,
  "name": "Steel Panther",
  "notes": "",
  "occurs_at": "2024-05-08T20:00:00Z",
  "occurs_at_local": "2024-05-08T20:00:00-05:00",
  "performances": [
    {
      "performer": {
        "id": 10638,
        "name": "Steel Panther",
        "slug": "steel-panther",
        "slug_url": "/performers/steel-panther",
        "url": "/performers/10638"
      },
      "primary": true
    }
  ],
  "popularity_score": 0,
  "promotion_label": "",
  "requirements": {
    "face_value_display": false,
    "inclusive_pricing": true,
    "seat_number_display": false
  },
  "state": "shown",
  "updated_at": "2024-02-03T17:27:59Z",
  "url": "/events/2585673",
  "venue": {
    "address": {
      "country_code": "US",
      "created_at": "2012-04-12T03:38:53Z",
      "extended_address": null,
      "label": null,
      "latitude": 36.1523805,
      "locality": "Nashville",
      "location": "Nashville, TN",
      "longitude": -86.7893889,
      "postal_code": "37203",
      "region": "TN",
      "street_address": "1402 Clinton Street"
    },
    "id": 16281,
    "location": "Nashville, TN",
    "name": "Marathon Music Works",
    "slug": "marathon-music-works",
    "slug_url": "/venues/marathon-music-works",
    "time_zone": "America/Chicago",
    "url": "/venues/16281"
  }
}