V1 REST Endpoints

Complete REST API reference for the V1 API — 30+ endpoints across 9 sports

Base URL Pattern

https://v1.{sport}.sportsapipro.com

Replace {sport} with: football, basketball, tennis, hockey, handball, american-football, baseball, volleyball, rugby

Global Endpoints

These endpoints work across all sports.

Endpoint	Description
GET /api/v1/scores	All games across all 9 sports (live + scheduled + recently ended)
GET /api/v1/sports	List all available sports with IDs
GET /api/v1/search?q={query}	Search competitions, teams, countries
GET /api/v1/games?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD&sportId={id}	Games within a date range
GET /api/v1/news?sportId={id}	News filtered by sport, competition, or game
GET /api/v1/competitions?sportId={id}	Competitions filtered by sport or country

Per-Sport Endpoints

Replace {sport} with any slug (e.g., football, tennis, baseball).

Live & Schedule

Endpoint	Description
GET /api/v1/{sport}/live	Live scores (in-progress games only)
GET /api/v1/{sport}/all	All scores (live + scheduled + ended)
GET /api/v1/{sport}/current	Current games
GET /api/v1/{sport}/competitions	Active competitions for this sport
GET /api/v1/{sport}/countries	Countries with active competitions
GET /api/v1/{sport}/news	Sport-specific news

Game Detail

Endpoint	Description
GET /api/v1/game/{gameId}	Full game details (events, lineups, venue, officials, etc.)
GET /api/v1/game/{gameId}/events	Match events (goals, cards, substitutions)
GET /api/v1/game/{gameId}/lineups	Home + away lineups with formation
GET /api/v1/game/{gameId}/stats	Player stats from lineups
GET /api/v1/game/{gameId}/venue	Venue name, capacity, attendance
GET /api/v1/game/{gameId}/officials	Referees
GET /api/v1/game/{gameId}/members	Full squad members for both teams
GET /api/v1/game/{gameId}/stages	Period scores (halftime, fulltime)
GET /api/v1/game/{gameId}/chartevents	Timeline chart events
GET /api/v1/game/{gameId}/playbyplay	Play-by-play commentary feed
GET /api/v1/game/{gameId}/predictions	Promoted predictions

Competition Data

Endpoint	Description
GET /api/v1/competition/{id}/standings	League table (optional ?seasonNum={num} for historical)
GET /api/v1/competition/{id}/results	Recent completed games
GET /api/v1/competition/{id}/games	Upcoming + recent games
GET /api/v1/competition/{id}/stats	Top scorers, assists, ratings (16 stat categories)
GET /api/v1/competition/{id}/brackets	Knockout brackets/draw
GET /api/v1/competition/{id}/transfers	Player transfers
GET /api/v1/competition/{id}/news	Competition news

Team Data

Endpoint	Description
GET /api/v1/competitor/{id}/games	Team schedule (upcoming + recent)
GET /api/v1/competitor/{id}/results	Team past results

Head-to-Head

Endpoint	Description
GET /api/v1/h2h/{competitorId1}/{competitorId2}	All games between two teams

All game, competition, competitor, and H2H endpoints also work sport-scoped:

GET /api/v1/{sport}/game/{gameId}
GET /api/v1/{sport}/competition/{id}/standings
GET /api/v1/{sport}/competitor/{id}/games
GET /api/v1/{sport}/h2h/{id1}/{id2}

Example Requests

LaLiga Standings

curl -H "x-api-key: YOUR_API_KEY" \
  https://v1.football.sportsapipro.com/api/v1/football/competition/11/standings

Popular Competition IDs

Football

ID	Name
11	LaLiga
7	Premier League
35	Bundesliga
17	Serie A
23	Ligue 1
572	UEFA Champions League
573	UEFA Europa League

Basketball

ID	Name
53	NBA

Hockey

ID	Name
110	NHL

American Football

ID	Name
55	NFL

Baseball

ID	Name
113	MLB