API Reference

Introduction

The Intervals Partner API lets you build integrations that read and write running event data for your organization.

Base URL

All API requests are made against the following base URL.

https://api.intervals.run

What you can build

Pull your event series and upcoming runs into your own website
Create events programmatically from your internal tools
Sync participant data with your registration system
Build custom dashboards with live event data

Quick example

Fetch all event series for your organization with a single request.

curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/series

Versioning

The API does not use URL-based versioning. When breaking changes are introduced, we will version via calendar-based headers (e.g. Intervals-Version: 2026-03-01). Requests without a version header will always use the latest stable version. We’ll announce breaking changes well in advance and support previous versions for a migration period.

Next steps

Head to the Authentication page to learn how to create an API key and start making requests.