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

Events in a group

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

GET/groups/:slug/events
curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/groups/friday-night-lights/events?limit=20

Path Parameters

slugstringrequired

The group slug

Query Parameters

limitnumber

Maximum number of memberships to return (1-100)

Authorization

read:groups

Response — Membership

groupIdstringrequired

Group ID

eventIdstringrequired

Event ID

displayOrdernumber

Display order within the group

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

registrationUrlstring

Registration page URL

{
  "data": [
    {
      "groupId": "g14abc789def012",
      "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"
      }
    }
  ]
}
Retrieve a groupChangelog

Request

curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/groups/friday-night-lights/events?limit=20

Response

{
  "data": [
    {
      "groupId": "g14abc789def012",
      "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"
      }
    }
  ]
}