Five unified business APIs that power Kelball and external partners. Reads are public. Writes need an x-api-key.
Profiles, statistics, search, discovery.
GET /api/v1/athletesCompetitions, matches, results, rankings, replays.
GET /api/v1/competitionsEmerging talents, recommendations, matching, discovery.
GET /api/v1/scouting/prospectsScholarships, trials, showcases, talent requests.
GET /api/v1/opportunitiesClubs, academies, universities, recruiters.
GET /api/v1/organizationsStart free, upgrade when you need more volume or write access.
Same plans automatically apply to future sport-specific APIs (football, basketball, volleyball, rugby, combat).
# Public read — no key needed (counts against free tier IP limits)
curl https://your-domain/api/v1/athletes?limit=5
# Authenticated request (counts against your plan quota)
curl -H "x-api-key: kb_live_xxx.yyy" https://your-domain/api/v1/athletes/statistics
# List available plans
curl https://your-domain/api/v1/plansAPI keys are issued from the admin dashboard. Send the full key in either x-api-key or Authorization: Bearer …. Each key is bound to a plan that enforces daily and monthly request quotas. When you exceed your quota the API returns 429 quota_exceeded.
Current major version is v1 at /api/v1. Future versions live at /api/v2 without breaking /api/v1. Planned business subdomains (athletes, competitions, scouting, opportunities, organizations) and sport subdomains (football, basketball, volleyball, rugby, combat, tennis, athletics, swimming, cycling, handball) all inherit the same APIs, plans, quotas and billing.