Divisions

Divisions belong to a league and hold teams. Each division tracks its own standings, schedule, and configuration.

Endpoint: /api/v1/divisions Required scope: read:leagues (read) / admin (write)

Endpoints

Method	Path	Auth	Description
GET	`/api/v1/divisions?league=:id`	Recommended	List all divisions for a league
GET	`/api/v1/divisions/:id`	Recommended	Get a single division (includes standings)
POST	`/api/v1/divisions`	Required	Create a division within a league
PUT	`/api/v1/divisions/:id`	Required	Update a division

Allowed ?include= roots: league, organization, paymentProduct. By default, league is returned as an ObjectId string; pass ?include=league to get it as a nested object. See Query Parameter: ?include=.

Division Fields

Field	Type	Description
`_id`	ObjectId	Unique identifier
`name`	string	Division name (required)
`organization`	ObjectId	Owning organization (ref: Organization)
`league`	ObjectId	Parent league (ref: League)
`sports`	string[]	Sports for this division. Default: `[]`
`priority`	number	Display sort order
`paymentProduct`	ObjectId	Payment product override (ref: PaymentProduct)
`config`	ConfigSchema	Division-level configuration (highest precedence)
`strengthLevel`	number	Skill level indicator
`startDate`	date	Division start date
`endDate`	date	Division end date
`created`	date	Creation timestamp
`updated`	date	Last update timestamp

ConfigSchema Fields

Division config overrides league, tournament, and registration config. See Config Hierarchy for details.

Field	Type	Default	Description
`requirePlayers`	boolean	—	Teams must add players to complete registration
`hideTeams`	boolean	—	Hide team names from public views
`hideSchedules`	boolean	—	Hide the public Schedule tab and its content. Resolves through the config hierarchy; unset inherits from the contest/tournament/registration and defaults to visible.
`hideStandings`	boolean	—	Hide the public division Standings tab
`showStats`	boolean	—	Whether stats are visible to the public. Resolves through the config hierarchy; unset falls through and defaults to show. (The legacy org-level `hideStats` fallback was retired.)
`gameStats`	Record<sport, string[]>	—	Sport-keyed raw per-game stat keys shown in box scores, game logs, and the admin entry grid (e.g. `{ basketball: ['points','totalRebounds'] }`). Public aggregate columns are derived from this via `inferDisplayStats`. Resolves through the config hierarchy.
`excludeTeamName`	boolean	—	Show player names instead of a team name (the team-name field is skipped at registration and a name is auto-generated). Unset resolves to true for individual/doubles sports (pickleball, golf, tennis) and false otherwise; an explicit value at any tier wins.
`minPlayers`	number	—	Minimum players per team
`maxPlayers`	number	—	Maximum players per team
`gameDurationInMinutes`	number	—	Default game duration
`requireCoaches`	boolean	—	Teams must add coaches
`requireTeamRepresentatives`	boolean	—	Teams must add team representatives
`minTeamRepresentatives`	number	—	Minimum team representatives
`maxTeamRepresentatives`	number	—	Maximum team representatives
`minCoaches`	number	—	Minimum coaches
`maxCoaches`	number	—	Maximum coaches
`capacity`	number	—	Max teams. Unset inherits from the contest/tournament/registration; `0` means no limit at this level and also falls through to the parent.
`waitlistCapacity`	number	`0`	Waitlist spots (0 = no waitlist)
`autoPromote`	boolean	—	Auto-promote waitlisted teams when a spot opens. Unset inherits.
`promotionPaymentWindowHours`	number	—	Controls FIFO ordering window for promoted teams (does not gate seating). Unset inherits, then falls back to 48.
`disableSync`	boolean	—	Disable automatic sync
`admins`	string[]	`[]`	Additional admin user IDs
`tiebreakers`	object	—	Tiebreaker rules per sport (basketball, football, baseball, soccer)
`gateByStartDate`	boolean	—	Registration-level only (read directly off `registration.config`, not via hierarchy). When true, the registration is publicly viewable but registrations are blocked until `registration.startDate`. Managed via `isBeforeRegistrationStart()` in `registrationSchedule.ts`. Default off.

Create a Division


curl -X POST https://api.staty.io/api/v1/divisions \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Competitive",
    "league": "league_abc123",
    "config": {
      "capacity": 12,
      "minPlayers": 7,
      "maxPlayers": 15,
      "gameDurationInMinutes": 50
    }
  }'

Response:


{
  "success": true,
  "data": {
    "_id": "div_def456",
    "name": "Competitive",
    "league": "league_abc123",
    "config": {
      "capacity": 12,
      "minPlayers": 7,
      "maxPlayers": 15,
      "gameDurationInMinutes": 50,
      "waitlistCapacity": 0,
      "autoPromote": false,
      "promotionPaymentWindowHours": 48
    },
    "created": "2026-03-15T10:00:00.000Z"
  }
}

Division config takes the highest precedence in the config hierarchy. See Config Hierarchy for how it interacts with league, tournament, and registration config.