Skip to main content
GET
Head-to-head between two CS2 teams

What it returns

Looks at every finished match between two HLTV team ids and produces three blocks:

summary

Match-level and map-level W/L counts plus draws, all from the path’s first id (hltv_id) perspective:

aggregated

Round-level analytics across every map with at least one ended round. null when no round data is available (yet-to-be-tracked or pure-walkover matches): (team_a = team, team_b = opponent throughout.)

recent_fixtures

Compact list of the most recent N fixtures, normalised to team’s perspective:
For full match metadata or per-map detail, follow the match_id to Get Match.

Required scope

  • Minimum: cs2:teams:read

Query

Example

Use cases

  • Pre-match models — feed the full aggregated block as features (CT/T splits, pistol conversion, race-to-N).
  • Display surfacessummary + recent_fixtures for the match preview UI.
  • Fundamental factors — first-kill win % and headshot % as priors for player-prop pricing.

Authorizations

X-API-Key
string
header
required

Tenant API key issued during onboarding

Path Parameters

hltv_id
integer
required
opponent_id
integer
required

Query Parameters

limit
integer
default:20

Most recent N fixtures.

Required range: 1 <= x <= 100

Response

Successful Response

The response is of type Response Get Team H2H Cs2 V1 Teams Hltv Id H2H Opponent Id Get · object.

Last modified on May 10, 2026