Head-to-Head

Get head-to-head history between two basketball teams

GET /games/h2h

Head-to-Head

cURL

curl --request GET \
  --url https://v1.basketball.sportsapipro.com/games/h2h \
  --header 'x-api-key: <api-key>'

V1 Legacy Endpoint — This is a V1 API endpoint. For new integrations, we recommend using the Basketball V2 API which provides richer data and more endpoints.

Overview

Returns historical head-to-head matchups between two teams, useful for pre-game analysis and betting insights.

Query Parameters

competitor1 · integer · required

First team ID

competitor2 · integer · required

Second team ID

numOfGames · integer · default: "10"

Number of historical games to return

Code Examples

cURL

curl -X GET "https://v1.basketball.sportsapipro.com/games/h2h?competitor1=678&competitor2=679&numOfGames=10" \
  -H "x-api-key: YOUR_API_KEY"

Response Structure

games · array

Array of historical matchups

Show Game Object

id · integer

Game identifier

date · string

Game date

homeCompetitor · object

Home team with final score

awayCompetitor · object

Away team with final score

winner · integer

ID of the winning team

summary · object

H2H summary statistics

Show Properties

team1Wins · integer

Number of wins for first team

team2Wins · integer

Number of wins for second team

averageTotal · number

Average combined score

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

competitor1 · integer · required

First team ID

Example:

678

competitor2 · integer · required

Second team ID

Example:

679

numOfGames · integer · default: 10

Number of historical games to return

Example:

10

Response

200

Head-to-head history retrieved successfully