Head to head

GET/v1/teams/{id}/head-to-head

Two teams' meetings: the record from the first team's side, home and away, average score and the last games.

Live and up

Parameters

Name	In	Type	About
`id` required	path	id	The team, by its id (tm_…). e.g. `tm_Z81WSSTP`
`opponent` required	query	id	Only this team, by its id (tm_…). e.g. `tm_GX2ASRW0`
`competition`	query	id	Only this competition, by its id (cp_…). e.g. `cp_11A6HQXJ`
`last`	query	integer	How many recent games, from 1 to 50. 10 if left out.

What comes back

data is one of these:

Field	Type	About
`team`	object
`team.id`	id	A team id.
`team.name`	string
`opponent`	object
`opponent.id`	id	A team id.
`opponent.name`	string
`summary`	object
`summary.games`	integer
`summary.won`	integer
`summary.lost`	integer
`summary.home`	string	Won-lost at home, like 4-2.
`summary.away`	string	Won-lost away.
`summary.average_points_for`	number or null
`summary.average_points_against`	number or null
`summary.first_date`	date or null
`summary.last_date`	date or null
`games`	array of object

Errors

400422401403429404 What each one means

Try it

Your key idrequired opponentrequired competition last

Your key stays in this browser.

curl "https://api.basketballapi.net/v1/teams/tm_Z81WSSTP/head-to-head?opponent=tm_GX2ASRW0&competition=cp_11A6HQXJ" \
  -H "Authorization: Bearer bba_live_your_key"

import requests

r = requests.get("https://api.basketballapi.net/v1/teams/tm_Z81WSSTP/head-to-head?opponent=tm_GX2ASRW0&competition=cp_11A6HQXJ",
                 headers={"Authorization": "Bearer bba_live_your_key"})
print(r.json()["data"])

const r = await fetch("https://api.basketballapi.net/v1/teams/tm_Z81WSSTP/head-to-head?opponent=tm_GX2ASRW0&competition=cp_11A6HQXJ", {
  headers: { Authorization: "Bearer bba_live_your_key" }
});
const { data } = await r.json();

$ctx = stream_context_create(['http' => [
    'header' => "Authorization: Bearer bba_live_your_key",
]]);
$r = json_decode(file_get_contents("https://api.basketballapi.net/v1/teams/tm_Z81WSSTP/head-to-head?opponent=tm_GX2ASRW0&competition=cp_11A6HQXJ", false, $ctx), true);

200Example answer, in shape

{
  "data": {
    "team": {
      "id": "tm_8EB4D858",
      "name": "Example name"
    },
    "opponent": {
      "id": "tm_8EB4D858",
      "name": "Example name"
    },
    "summary": {
      "games": 34,
      "won": 12,
      "lost": 12,
      "home": "text",
      "away": "text",
      "average_points_for": 7.5,
      "average_points_against": 7.5,
      "first_date": "2026-10-01",
      "last_date": "2026-10-01"
    },
    "games": [
      {
        "id": "gm_C513E9BF",
        "competition": {
          "id": "cp_929127FC",
          "name": "Example name"
        },
        "season": {
          "id": "ss_EBC81C6D",
          "name": "Example name"
        },
        "stage": "regular",
        "round": "12",
        "date": "2026-10-01",
        "tip_off": "2026-10-01T19:45:00Z",
        "status": "scheduled",
        "home": {
          "id": "tm_8EB4D858",
          "name": "Example name"
        },
        "away": {
          "id": "tm_8EB4D858",
          "name": "Example name"
        },
        "home_score": 88,
        "away_score": 81,
        "attendance": 11204,
        "venue": "text",
        "has": {
          "boxscore": true,
          "playbyplay": true,
          "shots": true
        }
      }
    ]
  },
  "meta": { "plan": "Free key" }
}