---
title: "Head-to-head series vs an opponent"
method: GET
path: "/api/teams/{id}/head-to-head"
tags: ["Teams"]
---

# Head-to-head series vs an opponent

`GET /api/teams/{id}/head-to-head`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/teams/{id}/head-to-head`
- Auth: none required

Public. { record: { wins, losses, ties }, meetings: [{ gameId, date, homeAbbr, awayAbbr, homeScore, awayScore }] } from the perspective of {id}. The 5 most recent decided meetings (live games excluded so the list and the record agree). Empty history is a valid 200. 400 without opponentId, 404 for unknown teams.

## Path parameters

- `id` string, required

## Query parameters

- `opponentId` string, required

## Response `200`

{ success, data: { record, meetings } }

## Other responses

- `400`: opponentId missing or equals teamId
- `404`: Team not found

## Changes

- **2026-09-12** `a8df6fe04343`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/teams/:id/head-to-head/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
