Discord

Players

get
Authorizations
Responses
200Success
application/json
get
GET /v1/players/legend-ranking-thresholds HTTP/1.1
Host: api.clashperk.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200Success
{
  "live": {
    "timestamp": "text",
    "thresholds": [
      {
        "rank": 1,
        "minTrophies": 1
      }
    ]
  },
  "eod": {
    "timestamp": "text",
    "thresholds": [
      {
        "rank": 1,
        "minTrophies": 1
      }
    ]
  },
  "history": [
    {
      "timestamp": "text",
      "thresholds": [
        {
          "rank": 1,
          "minTrophies": 1
        }
      ]
    }
  ]
}
post
Authorizations
Body
playerTagsstring[] · min: 1 · max: 100RequiredExample: ["#2PP"]
Responses
200Success
application/json
post
POST /v1/players/legend-attacks/query HTTP/1.1
Host: api.clashperk.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "playerTags": [
    "#2PP"
  ]
}
200Success
{
  "items": [
    {
      "tag": "text",
      "name": "text",
      "seasonId": "text",
      "trophies": 1,
      "logs": [
        {
          "timestamp": 1,
          "start": 1,
          "end": 1,
          "diff": 1,
          "type": "text"
        }
      ]
    }
  ]
}
get
Authorizations
Path parameters
playerTagstringRequired
Responses
200Success
application/json
get
GET /v1/players/{playerTag}/legend-attacks HTTP/1.1
Host: api.clashperk.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200Success
{
  "tag": "text",
  "name": "text",
  "seasonId": "text",
  "trophies": 1,
  "logs": [
    {
      "timestamp": 1,
      "start": 1,
      "end": 1,
      "diff": 1,
      "type": "text"
    }
  ]
}
get
Authorizations
Path parameters
playerTagstringRequired
Responses
200Success
application/json
get
GET /v1/players/{playerTag}/history HTTP/1.1
Host: api.clashperk.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200Success
{
  "items": [
    {
      "clan": {
        "tag": "text",
        "name": "text"
      },
      "playerTag": "text",
      "firstSeen": "2025-10-11T15:59:31.737Z",
      "lastSeen": "2025-10-11T15:59:31.737Z"
    }
  ]
}
get
Authorizations
Path parameters
playerTagstringRequired
Query parameters
startDatestring · date-timeOptional

Date string or timestamp in milliseconds

Responses
200Success
application/json
get
GET /v1/players/{playerTag}/wars HTTP/1.1
Host: api.clashperk.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200Success
{
  "items": [
    {
      "warType": 1,
      "startTime": "2025-10-11T15:59:31.737Z",
      "endTime": "2025-10-11T15:59:31.737Z",
      "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
Authorizations
Path parameters
playerTagstringRequired
Query parameters
startDatestring · date-timeOptional

Date string or timestamp in milliseconds

Responses
200Success
application/json
get
GET /v1/players/{playerTag}/wars/aggregate HTTP/1.1
Host: api.clashperk.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200Success
{
  "totalWars": 1,
  "totalAttacks": 1,
  "total3Stars": 1,
  "totalMissed": 1,
  "totalStars": 1
}
put
Authorizations
Path parameters
playerTagstringRequired
Responses
200Success
No content
put
PUT /v1/players/{playerTag} HTTP/1.1
Host: api.clashperk.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200Success
No content
PreviousLinksNextWars

Was this helpful?