What can I build with this endpoint?

A season or series calendar — every event in a collection, in the order you set (displayOrder), each with its own date and coordinates.

What are the lat and lng fields useful for?

Mapping and proximity. Drop every event on a map, or sort and filter by distance from a runner's location to power a 'races near me' experience — the coordinates are already resolved, so there's no geocoding on your end.

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.

What is the registrationUrl field for?

It's the canonical link to register for the event — point your own 'Register' button at it so signups still flow through Intervals.

How do I tell upcoming events from past ones?

Read temporalStatus — it resolves to past, in_progress, or future from the event's dates (timezone-safe), so you can badge live events, hide finished ones, or default your list to what's next.

Endpoints

Events in a collection

List events belonging to a collection, with the collection membership metadata and an inline event summary for each row.

GET/collections/:slug/events

curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/collections/lakefront-race-series/events?limit=20

Path Parameters

slugstringrequired

The collection slug

Query Parameters

limitnumberrequired

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

afterstring

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

Authorization

read:collections

Response — Membership

collectionIdstringrequired

Collection ID

eventIdstringrequired

Event ID

displayOrdernumber

Display order within the collection

eventobjectrequired

Member event details

Response — Event

idstringrequired

Event ID

namestringrequired

Event name

slugstringrequired

URL slug

typeenum<string>required

Event type

Available options: race,runClub,timeTrial,other

datestringrequired

Event date (YYYY-MM-DD)

organizationIdstringrequired

Owning organization ID

startTimestring

Start time (HH:MM)

addressobject

Event location

latnumber

Latitude

lngnumber

Longitude

descriptionstring

Event description

websiteUrlstring

Event website URL

cardImageUrlstring

Card image URL (grid/list thumbnails).

coverImageUrlstring

Cover/hero image URL (event pages).

registrationUrlstring

Registration page URL

temporalStatusenum<string>required

Derived from the event's dates: past | in_progress | future.

Available options: past,in_progress,future

{
  "data": [
    {
      "collectionId": "c14abc789def012",
      "eventId": "e72tuv901wxy234",
      "displayOrder": 1,
      "event": {
        "id": "e72tuv901wxy234",
        "name": "Lakefront 5K - June 14",
        "slug": "lakefront-5k-june-14",
        "type": "race",
        "date": "2025-06-14",
        "organizationId": "k57abc123def456",
        "temporalStatus": "future"
      }
    }
  ],
  "hasMore": false
}

What you can build

Request

curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/collections/lakefront-race-series/events?limit=20

Response

{
  "data": [
    {
      "collectionId": "c14abc789def012",
      "eventId": "e72tuv901wxy234",
      "displayOrder": 1,
      "event": {
        "id": "e72tuv901wxy234",
        "name": "Lakefront 5K - June 14",
        "slug": "lakefront-5k-june-14",
        "type": "race",
        "date": "2025-06-14",
        "organizationId": "k57abc123def456",
        "temporalStatus": "future"
      }
    }
  ],
  "hasMore": false
}

Endpoints

Events in a collection

List events belonging to a collection, with the collection membership metadata and an inline event summary for each row.

GET/collections/:slug/events

curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/collections/lakefront-race-series/events?limit=20

Path Parameters

slugstringrequired

The collection slug

Query Parameters

limitnumberrequired

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

afterstring

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

Authorization

read:collections

Response — Membership

collectionIdstringrequired

Collection ID

eventIdstringrequired

Event ID

displayOrdernumber

Display order within the collection

eventobjectrequired

Member event details

Response — Event

idstringrequired

Event ID

namestringrequired

Event name

slugstringrequired

URL slug

typeenum<string>required

Event type

Available options: race,runClub,timeTrial,other

datestringrequired

Event date (YYYY-MM-DD)

organizationIdstringrequired

Owning organization ID

startTimestring

Start time (HH:MM)

addressobject

Event location

latnumber

Latitude

lngnumber

Longitude

descriptionstring

Event description

websiteUrlstring

Event website URL

cardImageUrlstring

Card image URL (grid/list thumbnails).

coverImageUrlstring

Cover/hero image URL (event pages).

registrationUrlstring

Registration page URL

temporalStatusenum<string>required

Derived from the event's dates: past | in_progress | future.

Available options: past,in_progress,future

{
  "data": [
    {
      "collectionId": "c14abc789def012",
      "eventId": "e72tuv901wxy234",
      "displayOrder": 1,
      "event": {
        "id": "e72tuv901wxy234",
        "name": "Lakefront 5K - June 14",
        "slug": "lakefront-5k-june-14",
        "type": "race",
        "date": "2025-06-14",
        "organizationId": "k57abc123def456",
        "temporalStatus": "future"
      }
    }
  ],
  "hasMore": false
}

What you can build

Request

curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/collections/lakefront-race-series/events?limit=20

Response

{
  "data": [
    {
      "collectionId": "c14abc789def012",
      "eventId": "e72tuv901wxy234",
      "displayOrder": 1,
      "event": {
        "id": "e72tuv901wxy234",
        "name": "Lakefront 5K - June 14",
        "slug": "lakefront-5k-june-14",
        "type": "race",
        "date": "2025-06-14",
        "organizationId": "k57abc123def456",
        "temporalStatus": "future"
      }
    }
  ],
  "hasMore": false
}