Team Head-to-Head
Aggregate W/L plus deep round-level analytics across every finished match between two teams
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:
match_id to Get Match.
Required scope
- Minimum:
cs2:teams:read
Query
Example
Use cases
- Pre-match models — feed the full
aggregatedblock as features (CT/T splits, pistol conversion, race-to-N). - Display surfaces —
summary+recent_fixturesfor the match preview UI. - Fundamental factors — first-kill win % and headshot % as priors for player-prop pricing.
Authorizations
Tenant API key issued during onboarding
Query Parameters
Most recent N fixtures.
Required range:
1 <= x <= 100Response
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
Head-to-head between two CS2 teams