CS2 data reference
Enum reference
Every fixed value the API returns or accepts, in one place.
Every enumerated value in the API. All are lowercase unless shown otherwise, and all are exact and case-sensitive when used as a filter.
Match
| Field | Values |
|---|---|
status | scheduled · live · completed |
format | bo1 · bo3 · bo5 |
stage | Not an enum — free text (Quarterfinal, Group A, Grand Final). Don't switch on it. |
Tournament
| Field | Values |
|---|---|
tier | S · A · B · C (S highest) |
status | upcoming · ongoing · finished — derived from dates, null when starts_at is unknown |
region | Europe · North America · South America · Asia · CIS · Oceania · Africa |
Team and player
| Field | Values |
|---|---|
region (team) | Same seven full names as above. Not codes — EU matches nothing. |
country_code | ISO 3166-1 alpha-2, uppercase (UA, DE) |
role (player) | AWP · IGL · Lurker · Rifler · Support — populated on ~14% of players |
Odds
| Field | Values |
|---|---|
source | eo_market · eo_model — only ever these two |
outcome_key | home · away · over · under · odd · even, or a correct-score literal in a_b form with an underscore (2_1, 0_3) — team A's maps then team B's |
participant_type | team · player · null |
price | Decimal odds. Never American or fractional. |
Rounds and maps
| Field | Values |
|---|---|
team_side | ct · t (lowercase) |
choice_type (veto) | pick · ban · decider — decider has a null team_id |
map_name | Valve identifiers (de_ancient, de_mirage) |
hit_group | Head · Chest · Stomach · LeftArm · RightArm · LeftLeg · RightLeg · Gear · Generic |
grenade_name | Flashbang · Smoke Grenade · HE Grenade · Molotov · Incendiary Grenade · Decoy Grenade |
weapon_class | Rifle · Pistols · SMG · Heavy · Grenade · Equipment, or an empty string where the source didn't classify it |
Rankings
| Field | Values |
|---|---|
entity_type | team · player |
metric | glicko2_conservative (teams) · rating (players) |
window | 3mo |
Coverage
| Field | Values |
|---|---|
group | data · odds |
status | live · pending_validation · schema_ready · planned · licence_required |
Errors
missing_api_key · invalid_api_key · unauthorized · rate_limited · quota_exceeded ·
trial_quota_exceeded · unknown_game · not_found · invalid_cursor · invalid_parameter ·
conflict · forbidden · internal_error · unavailable
See Errors for which status each accompanies.
WebSocket frames
Client → server: subscribe · unsubscribe · pong
Server → client: snapshot · update · subscribed · unsubscribed · error
There is no heartbeat type — the server uses native WebSocket pings. See
Live data.