{ "matchId": 12345, "homeTeam": "Liverpool", "awayTeam": "Man City" }
GET /api/v1/matches Authorization: Bearer ... Content-Type: application/json
const response = await fetch(url); const data = await response.json();
{ "homeWinProb": 0.87, "confidence": "high" }
import { ApiService } from "@/services/api"; const api = new ApiService();
GET /api/v1/match-probabilities { "matchId": 12345 }

API Features

Football data APIs plus tenant auth, customers, and subscription tooling

The API blends structured football data, match analytics records, secure authentication, and subscription usage so you can ship analytics products confidently.

Football statistics catalog

Football catalog over REST: competitions, seasons, fixtures, standings, teams, scorers, persons, head-to-head, filters, paging, and OpenAPI docs.

  • Areas and competition directory endpoints
  • Paged fixtures, match detail, and search filters
  • Standings, scorers, and season-scoped views
  • Team and person profiles with related fixtures
  • Head-to-head history for a given match id
Match analytics records

Match analytics rows: modeled outcomes, fixture keys, and probability fields for reporting.

  • List and fetch match-probability rows by identifier
  • Admin create, update, and delete with RBAC rules
  • Modeled outcome codes plus structured probability fields
  • Internal and external ids for ingestion pipelines
  • Plan-metered reads where your subscription applies
Authentication & access

JWT sessions, tenant API keys, OAuth sign-in, and two-factor authentication for access.

  • Login, refresh-token, and logout flows
  • Google and GitHub OAuth sign-in endpoints
  • 2FA setup, verification, enable, and disable
  • Forgot-password and reset-password mail flows
  • Bearer tokens plus `sk-` style API key access
Tenants, customers & billing

Customer signup and CRUD, subscription lifecycle actions, and tenant usage views mapped to your billing plan.

  • Register, verify, list, update, and remove customers
  • Create subscriptions and upgrade, cancel, or renew
  • Current tenant profile and API key regeneration
  • Usage summaries and per-customer activity analytics
  • Preferences, localization, and password reset helpers