Intervals Developers
API Reference
Sign inGet API key
IntroductionAuthenticationErrorsPaginationRate LimitsIdempotency

Endpoints

GETYour organizationGETAll eventsGETRetrieve an eventPOSTCreate an eventGETAll registrationsPOSTRegister a participantGETAll recurrencesGETAll groupsGETRetrieve a groupGETEvents in a group
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

limitnumberdefault: 50

Maximum number of events to return (1-100)

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

registrationUrlstring

Registration page URL

{
  "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"
    }
  ]
}
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"
    }
  ]
}