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

tbd

Indicates whether the event date/time is To Be Determined

Boolean

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/2659875

{ "available_count": 397, "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": 14341, "name": "End Stage", "url": "/configurations/14341" }, "discount_magnitude": 0, "id": 2659875, "long_term_popularity_score": 0.1, "name": "David Gilmour", "notes": "", "occurs_at": "2024-11-10T19:30:00Z", "occurs_at_local": "2024-11-10T19:30:00-05:00", "owned_by_office": false, "performances": [ { "performer": { "id": 2940, "name": "David Gilmour", "slug": "david-gilmour", "slug_url": "/performers/david-gilmour", "url": "/performers/2940" }, "primary": true } ], "popularity_score": 0, "products_count": 400, "promotion_label": "", "requirements": { "face_value_display": true, "inclusive_pricing": true, "seat_number_display": false }, "state": "shown", "updated_at": "2024-05-17T23:33:19Z", "url": "/events/2659875", "venue": { "address": { "country_code": "US", "created_at": "2012-04-12T03:35:33Z", "extended_address": "", "label": null, "latitude": 40.750414267338, "locality": "New York", "location": "New York, NY", "longitude": -73.9934373661316, "postal_code": "10001", "region": "NY", "street_address": "4 Pennsylvania Plaza" }, "id": 896, "location": "New York, NY", "name": "Madison Square Garden", "slug": "madison-square-garden", "slug_url": "/venues/madison-square-garden", "time_zone": "America/New_York", "url": "/venues/896" } }