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

Endpoints

All collections

Retrieve a list of event collections for your organization. A collection is a branded series that bundles distinct, independently-run events under one slug and profile page — Abbott World Marathon Majors, UTMB World Series, a local summer race series. An event can belong to several collections. Use collections to power a series landing page or season schedule on your own site.

GET/collections
curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/collections?status=active&limit=20

Query Parameters

limitnumberrequired

Items per page (1-100, default 50).

afterstring

Opaque cursor from a previous response's `cursor` field; returns the next page.

statusenum<string>

Filter by lifecycle status

Available options: active,paused,archived

Authorization

read:collections

Response

idstringrequired

Collection ID

organizationIdstringrequired

Owning organization ID

namestringrequired

Collection name

slugstringrequired

URL-friendly slug (unique)

descriptionstring

Collection description

statusenum<string>required

Lifecycle status

Available options: active,paused,archived

cardImageUrlstring

Card image URL (if set).

coverImageUrlstring

Cover image URL (if set).

{
  "data": [
    {
      "id": "c14abc789def012",
      "organizationId": "k57abc123def456",
      "name": "Lakefront Race Series",
      "slug": "lakefront-race-series",
      "description": "Our seasonal series of lakefront road races.",
      "status": "active",
      "cardImageUrl": "https://cdn.intervals.run/collections/lakefront-race-series-card.jpg"
    }
  ],
  "hasMore": false
}

What you can build

All recurrencesRetrieve a collection

Request

curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/collections?status=active&limit=20

Response

{
  "data": [
    {
      "id": "c14abc789def012",
      "organizationId": "k57abc123def456",
      "name": "Lakefront Race Series",
      "slug": "lakefront-race-series",
      "description": "Our seasonal series of lakefront road races.",
      "status": "active",
      "cardImageUrl": "https://cdn.intervals.run/collections/lakefront-race-series-card.jpg"
    }
  ],
  "hasMore": false
}