Table of Contents

Getting Started

Coverage

What leagues do you cover, and at what level?

Coverage information can be found via our Coverage Matrix.

Integration

What format are date fields presented in?

Date values are presented in the ISO 8601 standard format.

Timestamp fields are in UTC. These could include scheduled start times or play-by-play event timestamps. Examples: scheduled="2024-02-11T23:30:00+00:00", created_at="2024-02-11T23:43:20+00:00"

Date-only fields reflect local league convention and are not UTC-adjusted. These could include season start dates and birth dates. Examples: start_date="2024-08-16", date_of_birth="1984-09-22"

How do I locate the TTL (Time to Live)/cache on an API endpoint?

The cache (in seconds) can be accessed in the returned header information on each RESTful API call, under cache-control.

ex. cache-control: max-age=1, public, s-maxage=1 or
cache-control: public, must-revalidate, max-age=120

Back to top ↑

Event Data

Stage Values

What are the valid stage - status values?

Here are the valid stage.status values and their definitions:

• Preliminary - results are entered but not completed (e.g. first 10 racers for a stage).
• Completed - daily result is completed for a stage, or overall.
• Closed - stage and overall results have been confirmed and verified.
• Cancelled - stage or overall event is cancelled.
• Running - the stage is in progress.

What are the valid stage - classification values?

Here are the valid stage.classification values:

• individual_time_trial
• team_time_trial
• flat
• medium_mountain
• high_mountain
• no_classification

What are the valid stage - type values?

Here are the valid stage.type values:

• stage
• event
• discipline
• season
• sport

Back to top ↑