# 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

## Query Parameters
- limit (number): Maximum number of groups to return (1-100)
- slug (string): Filter by exact slug match
- status (string): Filter by lifecycle status

## Authorization
read:groups

## Request Examples

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

### JavaScript
```javascript
const res = await fetch(
  "https://api.intervals.run/groups?status=active&limit=20",
  {
  headers: { Authorization: "Bearer INTERVALS_PARTNER_API_KEY" },
  }
);
const { data } = await res.json();
```

## Responses

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