API Reference
SportsBracket Public API
The SportsBracket API lets Club users read and manage their events, brackets and participants from external applications.
Base URL
https://api.sportsbracket.orgAll endpoints are versioned. Current version: v1
Authentication
All requests must include a valid API key as a Bearer token in the Authorization header. Generate API keys in your account settings.
curl https://api.sportsbracket.org/v1/events \
-H "Authorization: Bearer sk_live_your_key_here"API key format
Keys are prefixed with sk_live_ and are only shown once when generated. Store them securely.
Errors
All errors return a JSON object with an error field.
{
"error": "Invalid API key."
}| Status | Meaning |
|---|---|
| 400 | Bad request — missing or invalid parameter |
| 401 | Unauthorized — missing, invalid or revoked API key |
| 403 | Forbidden — your plan does not allow this action |
| 404 | Not found — resource does not exist or belongs to another user |
| 429 | Too many requests — rate limit exceeded |
| 500 | Server error |
Rate limits
Rate limits are applied per API key. When exceeded the API responds with 429 Too Many Requests. Specific limits are included in response headers.
Versioning
The API version is included in the URL path (/v1/). Breaking changes are released under a new major version. Old versions remain available until deprecated with advance notice via the Deprecation and Sunset response headers.