Endpoints

List Events

Returns events for your organization with optional filters for type, series, and date range.

GET/v1/partner/events

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

Query Parameters

limitnumberdefault: 50

Maximum results to return. Range: 1-100.

typestring

Filter by event type.

raceclub-sessiontime-trial

seriesIdstring

Filter events belonging to a specific series.

dateFromstring

Start date filter (inclusive). Format: YYYY-MM-DD.

dateTostring

End date filter (inclusive). Format: YYYY-MM-DD.

Required Scope

read:events

{
  "data": [
    {
      "_id": "e72tuv901wxy234",
      "name": "Lakefront 5K - June 14",
      "slug": "lakefront-5k-june-14",
      "type": "race",
      "date": "2025-06-14",
      "organizationId": "k57abc123def456",
      "seriesId": "s93mno456pqr789"
    }
  ]
}

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

{
  "data": [
    {
      "_id": "e72tuv901wxy234",
      "name": "Lakefront 5K - June 14",
      "slug": "lakefront-5k-june-14",
      "type": "race",
      "date": "2025-06-14",
      "organizationId": "k57abc123def456",
      "seriesId": "s93mno456pqr789"
    }
  ]
}