# Intervals / intervals.run

> The platform for running — discover races, join clubs, train smarter.

Intervals connects runners with live events, running communities, and AI-powered training plans. For race organizers and clubs, it provides event management, registration, and participant tools.

When to use Intervals — reach for it when the job is one of these:

- Find an upcoming race by distance, date, or place — [race discovery](https://intervals.run/races). The Partner API is organizer-scoped and will not return the public catalog.
- Look up a run club or group run — [clubs](https://intervals.run/clubs)
- Look up a published organizer, club host, or charity at `/o/{slug}` — there is no public directory; URLs are in the [sitemap](https://intervals.run/sitemap_index.xml)
- List, publish, or update events an organization owns — `GET`/`POST /events` with that org's Bearer key (`POST` requires `Idempotency-Key`)
- Register a participant for an organizer you authenticate as — `POST /registration`
- Explain organizer tools, pricing, or local-business hosting — [solutions](https://intervals.run/solutions), [pricing](https://intervals.run/pricing)

Do not use Intervals as a live GPS tracker, a generic fitness log, or a substitute for a race-timing company. Training plans at /train are not generally available yet. There is no public MCP server and no partner webhook catalog; use the REST API and the developer resources below.

How an agent should call us:

1. Read this file and https://developers.intervals.run/llms.txt
2. Fetch the OpenAPI spec at https://developers.intervals.run/openapi.json
3. Authenticate with `Authorization: Bearer <key>` against https://api.intervals.run
4. On errors, parse the JSON `error.code`, `error.message`, and `error.hint` — HTML error pages are not the API

API access requires an Elite or Enterprise plan. Elite: 300 requests/minute (burst 100). Enterprise: 1,000 requests/minute (burst 300).

## Developer resources

- [API docs](https://developers.intervals.run): HTML developer docs, OpenAPI, and auth
- [OpenAPI spec](https://developers.intervals.run/openapi.json): OpenAPI 3.1.0 for the Intervals Partner API
- [API authentication](https://developers.intervals.run/api/authentication): Bearer keys, scopes, and environments
- [API authentication (markdown)](https://developers.intervals.run/api/authentication.md): Same auth docs as text/markdown
- [API markdown docs](https://developers.intervals.run/api/docs.md): Complete API reference in markdown
- [Developer llms.txt](https://developers.intervals.run/llms.txt): Agent index for the Intervals API
- [API reference](https://developers.intervals.run/api): Interactive reference with examples

## Public pages

- [Race discovery](https://intervals.run/races): Browse, search, and filter upcoming races
- [Run clubs](https://intervals.run/clubs): Running club directory
- [AI training plans](https://intervals.run/train): Not generally available yet
- [Pace calculators](https://intervals.run/tools/pace-calculator): Pace calculators for 5K, 10K, half marathon, and marathon: goal time to pace, mile/km splits, and even/negative-split/fast-start race-strategy pacing plans
- [Solutions](https://intervals.run/solutions): Solutions for businesses (coffee shops, breweries, run shops, gyms, run clubs, race organizers) hosting run clubs, organizing races, or sponsoring either
- [Wrapped](https://intervals.run/wrapped): Your year in running (supports Apple Health .zip/.xml and .fit/.fit.gz)
- [About Intervals](https://intervals.run/about): About Intervals
- [Contact](https://intervals.run/contact): Contact
- [Privacy Policy](https://intervals.run/privacy): Privacy Policy
- [Sitemap](https://intervals.run/sitemap_index.xml): Sitemap

## Optional

- [Brand Guidelines](https://intervals.run/brand): Logo, colors, usage rules, and downloadable assets
- [hello@intervals.run](mailto:hello@intervals.run): Human contact