---
title: "Returns one archived esports match in full: maps played and per-player statistics."
method: GET
path: "/api/v1/history/cs2/matches/{matchId}"
tags: ["Historical data"]
---

# Returns one archived esports match in full: maps played and per-player statistics.

`GET /api/v1/history/cs2/matches/{matchId}`

## Request

- Base URL: `https://api.owlsinsight.com`
- URL: `https://api.owlsinsight.com/api/v1/history/cs2/matches/{matchId}`
- Auth: HTTP bearer

Returns one archived esports match in full: maps played and per-player statistics.

Historical endpoints share a per-key in-flight limit that is lower than the general concurrent-request limit. A request beyond it returns 429 with a Retry-After header giving the delay in seconds; wait that long and resend.

503 with a Retry-After header means the archive could not serve that request: the query was too expensive to run in one request, or the archive read path was busy. Wait the indicated seconds before resending; if it repeats, narrow the request with the filters this endpoint accepts.

matchId is numeric; anything else returns 400.

## Path parameters

- `matchId` string, required

## Response `200`

OK

- CS2MatchDetailResponse
  - `data` CS2MatchDetail
    - `bestOf` number, double
    - `eventName` string
    - `isLan` boolean
    - `maps` CS2MapResult[]
      - `mapName` string
      - `mapNumber` number, double
      - `playerStats` CS2PlayerStat[]
        - `adr` number, double, nullable
        - `deaths` number, double
        - `kast` number, double, nullable
        - `kills` number, double
        - `playerId` number, double, nullable
        - `playerName` string
        - `rating` number, double, nullable
        - `teamName` string
      - `team1Score` number, double
      - `team2Score` number, double
    - `matchDate` string
    - `matchId` number, double
    - `matchUrl` string
    - `overallStats` CS2PlayerStat[]
      - `adr` number, double, nullable
      - `deaths` number, double
      - `kast` number, double, nullable
      - `kills` number, double
      - `playerId` number, double, nullable
      - `playerName` string
      - `rating` number, double, nullable
      - `teamName` string
    - `score1` number, double
    - `score2` number, double
    - `stars` number, double
    - `team1` string
    - `team2` 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)