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 events

Retrieve a list of events for your organization. Filter by type, series, or date range to narrow results.

GET/events
curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/events?type=race&dateFrom=2025-06-01&dateTo=2025-06-30&limit=20

Query Parameters

limitnumberrequireddefault: 50

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

afterstring

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

typeenum<string>

Filter by event type

Available options: race,runClub,timeTrial,other

dateFromstring

Filter events on or after this date (YYYY-MM-DD)

dateTostring

Filter events on or before this date (YYYY-MM-DD)

Authorization

read:events

Response

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": [
    {
      "id": "e72tuv901wxy234",
      "name": "Lakefront 5K - June 14",
      "slug": "lakefront-5k-june-14",
      "type": "race",
      "date": "2025-06-14",
      "organizationId": "k57abc123def456",
      "startTime": "08:00",
      "description": "Weekly lakefront 5K race along the scenic shore path.",
      "websiteUrl": "https://northshorerace.com/lakefront-5k",
      "temporalStatus": "future"
    }
  ],
  "hasMore": false
}

What you can build

Your organizationRetrieve an event

Request

curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/events?type=race&dateFrom=2025-06-01&dateTo=2025-06-30&limit=20

Response

{
  "data": [
    {
      "id": "e72tuv901wxy234",
      "name": "Lakefront 5K - June 14",
      "slug": "lakefront-5k-june-14",
      "type": "race",
      "date": "2025-06-14",
      "organizationId": "k57abc123def456",
      "startTime": "08:00",
      "description": "Weekly lakefront 5K race along the scenic shore path.",
      "websiteUrl": "https://northshorerace.com/lakefront-5k",
      "temporalStatus": "future"
    }
  ],
  "hasMore": false
}