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

Retrieve an event

Retrieve a single event along with its associated runs (distance variants), including event details and an array of event runs.

GET/events/:id
curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/events/e72tuv901wxy234

Path Parameters

idstringrequired

The event ID

Authorization

read:events

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

endDatestring

End date for multi-day events (YYYY-MM-DD)

endTimestring

End time (HH:MM)

Response — Run

_idstringrequired

Event run ID

eventIdstringrequired

Parent event ID

distanceMetersnumberrequired

Distance in meters

distanceStandardenum<string>required

Standard distance label

Available options: 5K,10K,15K,Half Marathon,Marathon,50K,50M,100K,100M,Ultra,Other

distanceLabelstringrequired

Display label for the distance

datestringrequired

Run date (YYYY-MM-DD)

startTimestring

Start time (HH:MM)

eventStatusenum<string>

Run status

Available options: scheduled,cancelled,postponed,rescheduled

registrationUrlstring

Registration URL

registrationOpensAtstring

Registration opens (ISO-8601 + offset)

registrationClosesAtstring

Registration closes (ISO-8601 + offset)

soldOutboolean

Capacity reached

registrationOverrideenum<string>

Manual registration override (paused = temporarily suspended, closed = forced closed)

Available options: paused,closed

maxParticipantsnumber

Maximum participants

isVirtualboolean

Whether this is a virtual run

isRelayboolean

Whether this is a relay

isWalkingboolean

Whether this is a walking event

{
  "data": {
    "event": {
      "_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"
    },
    "runs": [
      {
        "_id": "r41abc567def890",
        "eventId": "e72tuv901wxy234",
        "distanceMeters": 5000,
        "distanceStandard": "5K",
        "distanceLabel": "5K",
        "date": "2025-06-14",
        "startTime": "08:00",
        "eventStatus": "scheduled"
      }
    ]
  }
}
All eventsCreate an event

Request

curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/events/e72tuv901wxy234

Response

{
  "data": {
    "event": {
      "_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"
    },
    "runs": [
      {
        "_id": "r41abc567def890",
        "eventId": "e72tuv901wxy234",
        "distanceMeters": 5000,
        "distanceStandard": "5K",
        "distanceLabel": "5K",
        "date": "2025-06-14",
        "startTime": "08:00",
        "eventStatus": "scheduled"
      }
    ]
  }
}