Skip to main content
GET
Head-to-Head
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

integer
required
First team ID
integer
required
Second team ID
integer
default:"10"
Number of historical games to return

Code Examples

Response Structure

array
Array of historical matchups
object
H2H summary statistics

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

Last modified on June 29, 2026