---
title: "Returns head-to-head history and recent form for one scoreboard event."
method: GET
path: "/api/v1/{sport}/stats/h2h"
tags: ["Player stats"]
---

# Returns head-to-head history and recent form for one scoreboard event.

`GET /api/v1/{sport}/stats/h2h`

## Request

- Base URL: `https://api.owlsinsight.com`
- URL: `https://api.owlsinsight.com/api/v1/{sport}/stats/h2h`
- Auth: HTTP bearer

Returns head-to-head history and recent form for one scoreboard event.

404 when the eventId is not on the live scoreboard or has no head-to-head data.

## Path parameters

- `sport` string, required

## Query parameters

- `eventId` string, required

## Response `200`

OK

- H2HResponse
  - `data` object
    - `eventId` string
    - `h2h` H2HData
      - `awayCountry` string
      - `awayRanking` number, double
      - `awaySlug` string
      - `headToHead` RecentGame[]
        - `awayTeam` string
        - `date` number, double
        - `homeSide` boolean
        - `homeTeam` string
        - `matchId` string
        - `result` string
        - `score` string
        - `surface` string
        - `tournament` string
      - `homeCountry` string
      - `homeRanking` number, double
      - `homeSlug` string
      - `lastGamesAway` RecentGame[]
        - `awayTeam` string
        - `date` number, double
        - `homeSide` boolean
        - `homeTeam` string
        - `matchId` string
        - `result` string
        - `score` string
        - `surface` string
        - `tournament` string
      - `lastGamesHome` RecentGame[]
        - `awayTeam` string
        - `date` number, double
        - `homeSide` boolean
        - `homeTeam` string
        - `matchId` string
        - `result` string
        - `score` string
        - `surface` string
        - `tournament` string
      - `surfaceFilter` string
    - `sport` string
  - `success` boolean

---

[API](https://skmtc.dev/owlsinsight/apis/owls-insight-api.md) · [All operations](https://skmtc.dev/owlsinsight/apis/owls-insight-api/llms.txt) · [OpenAPI document](https://skmtc.dev/owlsinsight/apis/owls-insight-api/revisions/76c1ea016ff1?raw)