SportsBracket

v1

Events

Read events that belong to the authenticated Club user.

GET/v1/events

Returns all events belonging to the authenticated user, ordered by creation date descending. Maximum 200 records.

Request

curl https://api.sportsbracket.org/v1/events \
  -H "Authorization: Bearer sk_live_your_key_here"

Response

{
  "events": [
    {
      "id": 1,
      "name": "Spring Open 2026",
      "date": "2026-04-05T10:00:00.000Z",
      "location": "Stockholm Arena",
      "description": null,
      "status": "active",
      "eventType": "national",
      "registrationOpen": false,
      "createdAt": "2026-01-15T09:00:00.000Z"
    }
  ]
}
GET/v1/events/:id

Returns a single event by ID. Returns 404 if the event does not exist or belongs to another user.

Parameters

NameInTypeRequiredDescription
idpathintegerYesThe event ID.

Request

curl https://api.sportsbracket.org/v1/events/1 \
  -H "Authorization: Bearer sk_live_your_key_here"

Response

{
  "event": {
  "id": 1,
  "name": "Spring Open 2026",
  "date": "2026-04-05T10:00:00.000Z",
  "location": "Stockholm Arena",
  "description": null,
  "status": "active",
  "eventType": "national",
  "registrationOpen": false,
  "createdAt": "2026-01-15T09:00:00.000Z"
}
}

Field reference

statusdraft | active | completed | cancelled
eventTypenational | international | regional | club | null
registrationOpenWhether public self-registration is enabled