Tournaments

A Tournament is a bracket-style competition. Select a bracket size (8, 16, or 32 teams) and the bracket is auto-generated.

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

Endpoints

Method	Path	Auth	Description
GET	`/api/v1/tournaments`	Recommended	List all tournaments for your organization
GET	`/api/v1/tournaments/:id`	Recommended	Get a single tournament by ID
POST	`/api/v1/tournaments`	Required	Create a new tournament
PUT	`/api/v1/tournaments/:id`	Required	Update a tournament

Allowed ?include= roots: paymentProduct, contests, divisions. By default, paymentProduct is returned as an ObjectId — pass ?include=paymentProduct to get it populated. See Query Parameter: ?include=.

Fields

Field	Type	Description
`_id`	ObjectId	Unique identifier
`name`	string	Tournament name
`priority`	number	Display sort order
`sports`	string[]	Sports played. Default: `[]`
`startDate`	date	Tournament start date (optional)
`endDate`	date	Tournament end date (optional)
`active`	boolean	Whether the tournament is active. Default: `true`
`config`	ConfigSchema	Tournament-level configuration (see Config Hierarchy)
`paymentProduct`	ObjectId	Default payment product (ref: PaymentProduct)
`organization`	ObjectId	Owning organization (ref: Organization)
`created`	date	Creation timestamp
`updated`	date	Last update timestamp

Create a Tournament


curl -X POST https://api.staty.io/api/v1/tournaments \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Summer Classic 2026",
    "sports": ["basketball"],
    "startDate": "2026-07-12",
    "organization": "org_id_here"
  }'

Response:


{
  "success": true,
  "data": {
    "_id": "tourn_xyz789",
    "name": "Summer Classic 2026",
    "sports": ["basketball"],
    "startDate": "2026-07-12T00:00:00.000Z",
    "active": true,
    "organization": "org_id_here",
    "created": "2026-03-15T10:00:00.000Z"
  }
}

Update a Tournament


curl -X PUT https://api.staty.io/api/v1/tournaments/tourn_xyz789 \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "active": false
  }'