TriathlonLive API

getRetrieve Event Information

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

event_id:

required

integer

The unique id of the event to be returned

Result Format

Documentation

The **Retrieve Event Information** method retrieves a full event profile for a given `event_id`. This is suitable for producing complete event detail pages.
[block:callout]
{
"type": "danger",
"title": "Specifying a non-valid event_id will return a 404 response"
}
[/block]
The `event_news` object, if not null, contains the latest **5** news objects from the event. To get the full news listings consult the corresponding [Event News](https://developers.triathlon.org/docs/event-news) API method.
The `event_videos` object, if not null contains the latest **5** video objects from the event. To get the full video listings consult the corresponding [Event Videos](https://developers.triathlon.org/docs/event-videos) API method.
The `gallery` object if not null contains an array of **10** image objects from the event, which are inteded to be used as a gallery preview. To get the full gallery consult the corresponding [Event Web Images](https://developers.triathlon.org/docs/event-web-images) API method.
The `hr_gallery` key is a boolean that indicates whether a High Resolution Gallery exists for this event. To retrieve the gallery you should use the [Event High Resolution Gallery Method](https://developers.triathlon.org/docs/event-high-resolution-images) method (*use of these images is restricted*).
The `related_events` object contains an array of event objects for events at the **same venue**.
The `programs` object contains an array of program objects for the event, as such listing all races occurring at the event.
The following example returns the full event listing for event_id **90162**.
[block:code]
{
"codes": [
{
"code": "curl --header \"apikey: [[app:key]]\" https://api.triathlon.org/v1/events/90162",
"language": "curl"
}
]
}
[/block]