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 groups

Retrieve a list of event groups for your organization. Groups are logical brand collections (Abbott WMM, UTMB World Series, club Friday-night runs) that bundle related events under a single slug.

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

Query Parameters

limitnumber

Maximum number of groups to return (1-100)

slugstring

Filter by exact slug match

statusenum<string>

Filter by lifecycle status

Available options: active,paused,archived

Authorization

read:groups

Response

_idstringrequired

Group ID

organizationIdstringrequired

Owning organization ID

namestringrequired

Group name

slugstringrequired

URL-friendly slug (unique)

descriptionstring

Group description

statusenum<string>required

Lifecycle status

Available options: active,paused,archived

cardImageIdstring

Card image storage ID

coverImageIdstring

Cover image storage ID

{
  "data": [
    {
      "_id": "g14abc789def012",
      "organizationId": "k57abc123def456",
      "name": "Friday Night Lights",
      "slug": "friday-night-lights",
      "description": "Our weekly Friday evening track workouts.",
      "status": "active"
    }
  ]
}
All recurrencesRetrieve a group

Request

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

Response

{
  "data": [
    {
      "_id": "g14abc789def012",
      "organizationId": "k57abc123def456",
      "name": "Friday Night Lights",
      "slug": "friday-night-lights",
      "description": "Our weekly Friday evening track workouts.",
      "status": "active"
    }
  ]
}