Intervals Developers
API Reference
Sign inGet API key
IntroductionAuthenticationErrorsPaginationRate LimitsIdempotency

Endpoints

GETYour organizationGETAll eventsGETRetrieve an eventPOSTCreate an eventGETAll registrationsPOSTRegister a participantGETAll recurrencesGETAll collectionsGETRetrieve a collectionGETEvents in a collection
Changelog
Sign inGet API key

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 recurring schedules for your organization with a single request.

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

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 always use the latest stable version. The API is currently unversioned, so do not send an Intervals-Version header yet — an unrecognized version returns 400 BAD_REQUEST. We’ll announce each version in the changelog 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.

Authentication