Players

get

/v1/v2

/players/{playerTag}/history

Authorizations

bearer

AuthorizationstringRequired

in header (authorization: bearer [token])

Path parameters

playerTagstringRequired

Responses

200Success

application/json

500Error

application/json

get

/players/{playerTag}/history

HTTPcURLJavaScriptPython

GET /v1/players/{playerTag}/history HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "clan": {
        "tag": "text",
        "name": "text"
      },
      "playerTag": "text",
      "firstSeen": "2026-01-27T03:09:45.078Z",
      "lastSeen": "2026-01-27T03:09:45.078Z"
    }
  ]
}

get

/v1/v2

/players/{playerTag}/wars

Authorizations

bearer

AuthorizationstringRequired

in header (authorization: bearer [token])

Path parameters

playerTagstringRequired

Query parameters

startDatestring · date-timeRequired

Date string or timestamp in milliseconds

Responses

200Success

application/json

500Error

application/json

get

/players/{playerTag}/wars

HTTPcURLJavaScriptPython

GET /v1/players/{playerTag}/wars?startDate=2026-01-27T03%3A09%3A45.078Z HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "warType": 1,
      "startTime": "2026-01-27T03:09:45.078Z",
      "endTime": "2026-01-27T03:09:45.078Z",
      "attacks": [
        {
          "defender": {
            "tag": "text",
            "townHallLevel": 1,
            "mapPosition": 1
          },
          "stars": 1,
          "trueStars": 1,
          "defenderTag": "text",
          "destruction": 1
        }
      ],
      "season": "text",
      "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

/v1/v2

/players/{playerTag}/wars/aggregate

Authorizations

bearer

AuthorizationstringRequired

in header (authorization: bearer [token])

Path parameters

playerTagstringRequired

Query parameters

startDatestring · date-timeRequired

Date string or timestamp in milliseconds

Responses

200Success

application/json

500Error

application/json

get

/players/{playerTag}/wars/aggregate

HTTPcURLJavaScriptPython

GET /v1/players/{playerTag}/wars/aggregate?startDate=2026-01-27T03%3A09%3A45.078Z HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "season": "text",
      "totalWars": 1,
      "totalAttacks": 1,
      "total3Stars": 1,
      "totalMissed": 1,
      "totalStars": 1
    }
  ]
}

get

/v1/v2

/players/{playerTag}/clan-war-leagues/aggregate

Authorizations

bearer

AuthorizationstringRequired

in header (authorization: bearer [token])

Path parameters

playerTagstringRequired

Query parameters

startDatestring · date-timeRequired

Date string or timestamp in milliseconds

Responses

200Success

application/json

500Error

application/json

get

/players/{playerTag}/clan-war-leagues/aggregate

HTTPcURLJavaScriptPython

GET /v1/players/{playerTag}/clan-war-leagues/aggregate?startDate=2026-01-27T03%3A09%3A45.078Z HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "season": "text",
      "totalAttacks": 1,
      "totalMissed": 1,
      "totalDestruction": 1,
      "totalStars": 1,
      "totalWars": 1,
      "rounds": 1
    }
  ]
}

put

/v1/v2

/players/{playerTag}

Authorizations

bearer

AuthorizationstringRequired

in header (authorization: bearer [token])

Path parameters

playerTagstringRequired

Responses

200Success

application/json

500Error

application/json

put

/players/{playerTag}

HTTPcURLJavaScriptPython

PUT /v1/players/{playerTag} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "text"
}