What can I build with this endpoint?

A directory of your event series on your own site — each branded collection you organize (a race series, a grand prix), with its name, description, and ready-made card and cover images.

What are cardImageUrl and coverImageUrl for?

They're hosted, ready-to-render images for each event or collection — use cardImageUrl in a grid and coverImageUrl as a page hero, so you don't have to store or generate artwork yourself.

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

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
}