---
title: "Lists archived esports match results with map scores, filterable by team, event, date, star rating and LAN."
method: GET
path: "/api/v1/history/cs2/matches"
tags: ["Historical data"]
---

# Lists archived esports match results with map scores, filterable by team, event, date, star rating and LAN.

`GET /api/v1/history/cs2/matches`

## Request

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

Lists archived esports match results with map scores, filterable by team, event, date, star rating and LAN.

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.

Page one event at a time with limit and offset and stop when a page comes back shorter than limit. Do not fan out one request per book or market in parallel.

## Query parameters

- `team` string
- `event` string
- `startDate` string
- `endDate` string
- `stars` string
- `lan` string
- `limit` string
- `offset` string

## Response `200`

OK

- CS2MatchesResponse
  - `data` object
    - `matches` CS2Match[]
      - `bestOf` number, double
      - `eventName` string
      - `isLan` boolean
      - `matchDate` string
      - `matchId` number, double
      - `matchUrl` string
      - `score1` number, double
      - `score2` number, double
      - `stars` number, double
      - `team1` string
      - `team2` string
    - `pagination` object
      - `limit` number, double
      - `offset` number, double
      - `total` number, double, nullable: Total matching rows, or null when no filters applied (for performance).
  - `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)