API Reference

Changelog

Notable changes to the Intervals Partner API.

v1.5 — Awards & official results

September 2026
  • Added GET /events/{id}/awards — each run's award segments with depth and prizes, keyed by segmentId.
  • Added GET /events/{id}/results — published podiums per segment; publication is null until the organizer publishes. Filter with run, segment, and version.

v1.4 — Relay teams

July 2026
  • Added relay to run responses — leg boundaries and team size, on runs entered as a team.
  • Added entryCount to each run, alongside maxParticipants — teams registered on a run with relay.
  • Added teamId to participant responses.

v1.3 — Charity organizations

July 2026
  • New value charity in the organization roles enum.

v1.2 — Imagery & live capacity

June 2026
  • Added cardImageUrl and coverImageUrl to event and collection responses — hosted image URLs.
  • Added registrationCount to each run, alongside maxParticipants.

v1.1 — Event collections

April 2026
  • Added GET /collections and GET /collections/{slug} — list collections and fetch one by slug.
  • Added GET /collections/{slug}/events — a collection's member events, in displayOrder.
  • New scope read:collections gates the collection endpoints.

v1 — Initial Release

February 2026
  • 7 endpoints across organization, events, registrations, and recurrences.
  • Scope-based API key authentication — one key, one set of scopes.
  • Cursor-paginated list endpoints — limit plus an opaque after cursor.
  • Idempotent POST requests via Idempotency-Key.
  • Per-credential rate limiting, with Retry-After on 429s.