Discord

Players

get
/players/{playerTag}/history
Authorizations
AuthorizationstringRequired

in header (authorization: bearer [token])

Path parameters
playerTagstringRequired
Responses
200Success
application/json
get
/players/{playerTag}/history
GET /v1/players/{playerTag}/history HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "clan": {
        "tag": "text",
        "name": "text"
      },
      "playerTag": "text",
      "firstSeen": "2025-12-07T00:42:31.734Z",
      "lastSeen": "2025-12-07T00:42:31.734Z"
    }
  ]
}
get
/players/{playerTag}/wars
Authorizations
AuthorizationstringRequired

in header (authorization: bearer [token])

Path parameters
playerTagstringRequired
Query parameters
startDatestring · date-timeOptional

Date string or timestamp in milliseconds

Responses
200Success
application/json
get
/players/{playerTag}/wars
GET /v1/players/{playerTag}/wars HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "warType": 1,
      "startTime": "2025-12-07T00:42:31.734Z",
      "endTime": "2025-12-07T00:42:31.734Z",
      "attacks": [
        {
          "defender": {
            "tag": "text",
            "townHallLevel": 1,
            "mapPosition": 1
          },
          "stars": 1,
          "trueStars": 1,
          "defenderTag": "text",
          "destructionPercentage": 1
        }
      ],
      "id": 1,
      "clan": {
        "name": "text",
        "tag": "text"
      },
      "opponent": {
        "name": "text",
        "tag": "text"
      },
      "attacker": {
        "name": "text",
        "tag": "text",
        "townHallLevel": 1,
        "mapPosition": 1
      },
      "attacksPerMember": 1,
      "teamSize": 1
    }
  ]
}
get
/players/{playerTag}/wars/aggregate
Authorizations
AuthorizationstringRequired

in header (authorization: bearer [token])

Path parameters
playerTagstringRequired
Query parameters
startDatestring · date-timeOptional

Date string or timestamp in milliseconds

Responses
200Success
application/json
get
/players/{playerTag}/wars/aggregate
GET /v1/players/{playerTag}/wars/aggregate HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalWars": 1,
  "totalAttacks": 1,
  "total3Stars": 1,
  "totalMissed": 1,
  "totalStars": 1
}
put
/players/{playerTag}
Authorizations
AuthorizationstringRequired

in header (authorization: bearer [token])

Path parameters
playerTagstringRequired
Responses
200Success
No content
put
/players/{playerTag}
PUT /v1/players/{playerTag} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content
PreviousClansNextLegends

Last updated

Was this helpful?