V1 REST Endpoints - SportsAPI Pro

This page is the at-a-glance index. Each section links to a topic page with real samples, field references, and recipes.

Base URL Pattern

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

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

Scores

Live, scheduled, date-range scores.

Game Detail

Events, lineups, stats, venue, play-by-play.

Competitions

Standings, results, brackets, transfers.

Teams

Team fixtures and identity.

Head-to-Head

Previous meetings between two teams.

Search

Resolve names to IDs.

News

Sport/competition/game news.

Images

Logos, badges, flags, photos.

WebSocket

Real-time score streaming.

Recipes

Copy-paste integrations.

Global Endpoints

These endpoints work across all sports — front them with any sport prefix or use the global form https://api.sportsapipro.com/v1/{endpoint} (e.g. /v1/scores, /v1/sports).

Endpoint	Description
`GET /api/v1/scores`	All games across all 9 sports (live + scheduled + recently ended)
`GET /api/v1/sports`	List all 9 sports with IDs, slugs, and `drawSupport` flag
`GET /api/v1/search?q={query}`	Search competitions and competitors (teams/players) by name
`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, defensive stats — returns both player (`athletesStats`, 16 categories) and team (`competitorsStats`, 9 categories) arrays
`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}

Valid per-sport route names

V1 accepts only this vocabulary after the sport segment. Anything else returns 404 with the valid list in the body.

live | all | current | competitions | countries | news | game/{id}
competition/{id}/... | competitor/{id}/... | h2h/{id1}/{id2}

There is no today, schedule, fixtures or upcoming on V1. Use live for in-progress games, all for the full current window, and current for the paged “currently relevant” feed. For fixtures on a specific date use the global GET /v1/games?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD (optionally &sports={id}), or V2’s /v2/{sport}/schedule/{date} for richer schedule data.

Example Requests

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

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v1/football/game/4467358/events

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v1/football/h2h/131/132

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v1/search?q=barcelona"

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v1/baseball/all

Popular Competition IDs

Football

ID	Name
7	Premier League
11	LaLiga
16	Serie A
25	Bundesliga
12	Ligue 1
29	UEFA Champions League
35	UEFA Europa League
103	MLS
595	Saudi Pro League
5930	FIFA World Cup 2026

Basketball

ID	Name
53	NBA

Hockey

ID	Name
110	NHL

American Football

ID	Name
55	NFL

Baseball

ID	Name
113	MLB

​Base URL Pattern

Scores

Game Detail

Competitions

Teams

Head-to-Head

Search

News

Images

WebSocket

Recipes

​Global Endpoints

​Per-Sport Endpoints

​Live & Schedule

​Game Detail

​Competition Data

​Team Data

​Head-to-Head

​Valid per-sport route names

​Example Requests

​Popular Competition IDs

​Football

​Basketball

​Hockey

​American Football

​Baseball

Base URL Pattern

Global Endpoints

Per-Sport Endpoints

Live & Schedule

Game Detail

Competition Data

Team Data

Head-to-Head

Valid per-sport route names

Example Requests

Popular Competition IDs

Football

Basketball

Hockey

American Football

Baseball