The Event Listings method returns a paginated, filterable list of basic event objects matching the search criteria.

The following example list all 2015 World Triathlon Series events.

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

The category_id(https://developers.triathlon.org/docs/event-specifications) and specification_id(https://developers.triathlon.org/docs/event-specifications) parameters may be sourced from the respective API methods.

The nameparameter performs a search that matches any part of the event name. Whilst the search is fuzzy, typos are not considered and only direct matches are returned. For a better search experience, more suitable for user-defined input, it is recommended to use the Search API.

The start_date and end_date both expressed in yyyy-mm-dd format limit results by date. Only one parameter may be specified e.g. to find all events in the future simply the start_date param would be set.

The region_id parameter uses values from the Federation Region Listings method.

For many parameters you may supply a pipe delimited list of values to return multiple events, category_ids or specification_ids. For example another way to return all 2015 World Triathlon Series events by explicitly listing their event_id's would be:

curl --header "apikey: [[app:key]]" https://api.triathlon.org/v1/events?event_id=91028|90161|90162|90163|90164|91029|90165|90166|90167|90168

You may order the dates in either ascending or descending order by specifying the order parameter as either asc or desc.