Better-CS-API Docs
Matches

Matches ID

GET
/hltv/matches/{id}

Get the data from a specific HLTV match via match ID.

hltv.org/matches/{id}

Credits

  • 1 credit ($0.0012)

In case of errors, your credits are refunded automatically. Credits are not refunded for invalid IDs (404).

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

id*Id

The match ID. You can find this ID in the responses of /matches /results endpoint.

Example2395002

Response Body

application/json

application/json

curl -X GET "https://example.com/hltv/matches/2395002"
{  "id": 0,  "statsId": 0,  "date": 0,  "format": {    "type": "BO1",    "location": "LAN"  },  "status": "Live",  "hasScorebot": true,  "hasDemo": true,  "demoId": 0,  "team1": {    "name": "string",    "id": 0,    "rank": 0  },  "team2": {    "name": "string",    "id": 0,    "rank": 0  },  "winnerTeam": {    "name": "string",    "id": 0,    "rank": 0  },  "veto": [    {      "team": {        "name": "string",        "id": 0      },      "map": "default",      "type": "removed"    }  ],  "event": {    "id": 0,    "name": "string"  },  "maps": [    {      "name": "default",      "result": {        "team1TotalRounds": 0,        "team2TotalRounds": 0,        "halfResults": [          {            "team1Rounds": 0,            "team2Rounds": 0          }        ]      },      "statsId": 0,      "stats": {        "team1": {          "totalStats": [            {              "player": {                "id": 0,                "name": "string"              },              "kills": 0,              "deaths": 0,              "swing": 0,              "adr": 0,              "kast": 0,              "rating": 0,              "eKills": 0,              "eDeaths": 0,              "eAdr": 0,              "eKast": 0            }          ],          "tStats": [            {              "player": {                "id": 0,                "name": "string"              },              "kills": 0,              "deaths": 0,              "swing": 0,              "adr": 0,              "kast": 0,              "rating": 0,              "eKills": 0,              "eDeaths": 0,              "eAdr": 0,              "eKast": 0            }          ],          "ctStats": [            {              "player": {                "id": 0,                "name": "string"              },              "kills": 0,              "deaths": 0,              "swing": 0,              "adr": 0,              "kast": 0,              "rating": 0,              "eKills": 0,              "eDeaths": 0,              "eAdr": 0,              "eKast": 0            }          ]        },        "team2": {          "totalStats": [            {              "player": {                "id": 0,                "name": "string"              },              "kills": 0,              "deaths": 0,              "swing": 0,              "adr": 0,              "kast": 0,              "rating": 0,              "eKills": 0,              "eDeaths": 0,              "eAdr": 0,              "eKast": 0            }          ],          "tStats": [            {              "player": {                "id": 0,                "name": "string"              },              "kills": 0,              "deaths": 0,              "swing": 0,              "adr": 0,              "kast": 0,              "rating": 0,              "eKills": 0,              "eDeaths": 0,              "eAdr": 0,              "eKast": 0            }          ],          "ctStats": [            {              "player": {                "id": 0,                "name": "string"              },              "kills": 0,              "deaths": 0,              "swing": 0,              "adr": 0,              "kast": 0,              "rating": 0,              "eKills": 0,              "eDeaths": 0,              "eAdr": 0,              "eKast": 0            }          ]        }      }    }  ],  "players": {    "team1": [      {        "id": 0,        "name": "string"      }    ],    "team2": [      {        "id": 0,        "name": "string"      }    ]  },  "allMapStats": {    "team1": {      "totalStats": [        {          "player": {            "id": 0,            "name": "string"          },          "kills": 0,          "deaths": 0,          "swing": 0,          "adr": 0,          "kast": 0,          "rating": 0,          "eKills": 0,          "eDeaths": 0,          "eAdr": 0,          "eKast": 0        }      ],      "tStats": [        {          "player": {            "id": 0,            "name": "string"          },          "kills": 0,          "deaths": 0,          "swing": 0,          "adr": 0,          "kast": 0,          "rating": 0,          "eKills": 0,          "eDeaths": 0,          "eAdr": 0,          "eKast": 0        }      ],      "ctStats": [        {          "player": {            "id": 0,            "name": "string"          },          "kills": 0,          "deaths": 0,          "swing": 0,          "adr": 0,          "kast": 0,          "rating": 0,          "eKills": 0,          "eDeaths": 0,          "eAdr": 0,          "eKast": 0        }      ]    },    "team2": {      "totalStats": [        {          "player": {            "id": 0,            "name": "string"          },          "kills": 0,          "deaths": 0,          "swing": 0,          "adr": 0,          "kast": 0,          "rating": 0,          "eKills": 0,          "eDeaths": 0,          "eAdr": 0,          "eKast": 0        }      ],      "tStats": [        {          "player": {            "id": 0,            "name": "string"          },          "kills": 0,          "deaths": 0,          "swing": 0,          "adr": 0,          "kast": 0,          "rating": 0,          "eKills": 0,          "eDeaths": 0,          "eAdr": 0,          "eKast": 0        }      ],      "ctStats": [        {          "player": {            "id": 0,            "name": "string"          },          "kills": 0,          "deaths": 0,          "swing": 0,          "adr": 0,          "kast": 0,          "rating": 0,          "eKills": 0,          "eDeaths": 0,          "eAdr": 0,          "eKast": 0        }      ]    }  },  "streams": [    {      "name": "string",      "link": "string",      "viewers": 0    }  ],  "headToHead": [    {      "date": 0,      "winner": {        "name": "string",        "id": 0      },      "event": {        "id": 0,        "name": "string"      },      "map": "default",      "result": "string"    }  ],  "playerOfTheMatch": {    "id": 0,    "name": "string"  }}
Empty
Empty
Empty
{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string",      "input": null,      "ctx": {}    }  ]}
Empty