---
updatedAt: 2025-06-11T20:13:24.000Z
agentTools:
  projectIndex: https://developers.triathlon.org/llms.txt
---

# Getting Started with the Events API

Many resources are contained within events including results, program data, event images and start lists. As a result the Events API contains a large number of methods to explore.

[![Run in Postman](https://run.pstmn.io/button.svg)](https://app.getpostman.com/run-collection/9d5a74b5be18b9a80638)

## Event Methods

**[Event Listings](https://developers.triathlon.org/docs/event-listings)** returns a filterable list of event objects. This method is useful for displaying event listings or all events that meet a criteria e.g. WTS events in 2016. This method will allow determining of the unique `event_id` parameter that is required in all subsequent request types. Below we explore each of the available methods and provide a sample query for each.

```curl
curl --header "apikey: [[app:key]]" "https://api.triathlon.org/v1/events?category_id=351&start_date=2016-01-01&end_date=2017-01-01"
```

**[Retrieve Event Information](https://developers.triathlon.org/docs/retrieve-event-information)** returns a full event listing suitable for outputting an event detail page. This method also includes summary information for associated news, videos and images such that these results may be previewed without resorting to multiple API calls.

```curl
curl --header "apikey: [[app:key]]" "https://api.triathlon.org/v1/events/97636"
```

**[Event Web Images](https://developers.triathlon.org/docs/event-web-images)** returns a list of gallery objects for the event web galleries (all subject to usage restrictions) that you will find on Triathlon.org.

```curl
curl --header "apikey: [[app:key]]" "https://api.triathlon.org/v1/events/97636/images"
```

**[Event High Resolution Images](https://developers.triathlon.org/docs/event-high-resolution-images)** returns a list of gallery objects for High Resolution Images that were taken at the event (again all subject to usage restrictions).

```curl
curl --header "apikey: [[app:key]]" "https://api.triathlon.org/v1/events/97636/hr_images"
```

**[Event News](https://developers.triathlon.org/docs/event-news)** returns an array of news objects for all articles that have been associated with the event.

```curl
curl --header "apikey: [[app:key]]" "https://api.triathlon.org/v1/events/97636/news"
```

**[Event Videos](https://developers.triathlon.org/docs/event-videos)** returns an array of video objects for all videos that have been associated with the event.

```curl
curl --header "apikey: [[app:key]]" "https://api.triathlon.org/v1/events/97636/videos"
```

**[Event Twitter](https://developers.triathlon.org/docs/event-twitter)** acts as a proxy for the Twitter API allowing users to query the Twitter account of the event simply by knowing the event\_id.

```curl
curl --header "apikey: [[app:key]]" "https://api.triathlon.org/v1/events/97636/twitter"
```

**[Event Related Events](https://developers.triathlon.org/docs/event-related-events)** returns an array of event objects for other events happening at the same venue.

```curl
curl --header "apikey: [[app:key]]" "https://api.triathlon.org/v1/events/97636/related"
```

**[Event Medal Tally](https://developers.triathlon.org/docs/event-medal-tally)** returns an Olympic-style medal tally for a given event\_id

```curl
curl --header "apikey: [[app:key]]" "https://api.triathlon.org/v1/events/97636/medal_tally"
```

**[Event Medal Country Breakdown](https://developers.triathlon.org/docs/event-medal-country-breakdown)** returns the athletes corresponding to a country\_id that secured medals in a given event\_id.

```curl
curl --header "apikey: [[app:key]]" "https://api.triathlon.org/v1/events/97636/medal_tally/2356"
```

**[Event Specifications](https://developers.triathlon.org/docs/event-specifications)** returns a list of all available event specifications that may be used to filter event searches.

```curl
curl --header "apikey: [[app:key]]" "https://api.triathlon.org/v1/events/specifications"
```

**[Event Categories](https://developers.triathlon.org/docs/event-categories)** returns a list of all available event categories that may be used to filter event searches.

```curl
curl --header "apikey: [[app:key]]" "https://api.triathlon.org/v1/events/categories"
```

## Program Methods

Races at an event are referred to as **programs**. So one event contains many programs such as Elite Men, Elite Women, U23 Men etc... A large amount of data is also held at the program level such as atmospheric conditions, entries and results.

* **Program Listings** returns a filterable array of program objects for a given event\_id.
* **Retrieve Program Information** returns a full program listing for a given prog\_id (and associated event\_id). This method would return, if available, course distances, weather data and any associated notes.
* **Program Entries** returns an array of athlete objects for a given prog\_id (and associated event\_id) representing the start list of a program. It is also possible to view the waitlist of an event in the future provided that the 30-day window before the event has been met.
* **Program Results** returns an array of result objects for a given prog\_id (and associated event\_id).

## Sample Usage

Using the [World Triathlon Series](http://wts.triathlon.org/) website as an example to generate the following pages:

* 2016 Calendar Listing - Use the Event Listings method specifying parameters of category\_id=351, start\_date=2016-01-01 and end\_date=2016-01-01
* [Start List Page ](http://wts.triathlon.org/start_lists/2015_itu_world_triathlon_abu_dhabi/270293) use the program entries method to generate a list of athletes. For the expanded athlete profile information simply use the associated athlete\_id of each entry to make a request to the Retrieve Athlete Information method of the Athletes API.