# All events
Retrieve a list of events for your organization. Filter by type, series, or date range to narrow results.

GET /events

## Query Parameters
- limit (number): Maximum number of events to return (1-100)
- type (string): Filter by event type
- dateFrom (string): Filter events on or after this date (YYYY-MM-DD)
- dateTo (string): Filter events on or before this date (YYYY-MM-DD)

## Authorization
read:events

## Request Examples

### curl
```curl
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
```

### JavaScript
```javascript
const params = new URLSearchParams({
  type: "race",
  dateFrom: "2025-06-01",
  dateTo: "2025-06-30",
  limit: "20",
});
const res = await fetch(
  `https://api.intervals.run/events?${params}`,
  {
  headers: { Authorization: "Bearer INTERVALS_PARTNER_API_KEY" },
  }
);
const { data } = await res.json();
```

## Responses

### 200 (200)
```json
{
  "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"
    }
  ]
}
```