Get player statistics

Returns windowed per-leg statistics for one game type, using the same aggregation as the app. The per-leg rows are omitted; use the trend and games endpoints for history. The target must be the key owner or an accepted friend.

GET/players/{id}/statistics

Authorization

x-api-keyAPI key · headerrequired

A user (dp_) or organization (dp_org_) API key with read scopes.

Path parameters

idstringrequired

The entity id.

Query parameters

gameTypestringrequired

The game type to report.

Allowed:x01cricketkillerconquesthammer-cricket

windowstring | integer

Legs to include: auto (a bounded default), all, or an explicit count from 1 to 1000.

modestring

Optional mode filter for hammer cricket.

Allowed:normalteam

Responses

200

The player statistics.

One of:

object

gameTypestringrequired

windowintegerrequired

min -9007199254740991 · max 9007199254740991

lifetimePlayerLifetimeStatsrequired

Show properties

legsPlayedintegerrequired

min 0 · max 9007199254740991

winRatePlayednumberrequired

winRateWonnumberrequired

threeDartAvgnumber | null

tierPlayerTierrequired

Show properties

idstringrequired

Allowed:starternovicerecreationalintermediateadvancedsemi-proprofessionaleliteunranked

labelstringrequired

minAvgnumberrequired

descriptionstringrequired

metallicbooleanrequired

summaryobjectrequired

Show properties

legsPlayedintegerrequired

min 0 · max 9007199254740991

legsWonintegerrequired

min 0 · max 9007199254740991

threeDartAvgnumber | nullrequired

first9Avgnumber | nullrequired

avgUntil170number | nullrequired

checkoutAttemptsintegerrequired

min 0 · max 9007199254740991

checkoutSuccessintegerrequired

min 0 · max 9007199254740991

checkoutPctnumber | nullrequired

checkoutByBandobject[]required

Show properties

Array of object

bandstringrequired

Allowed:2-4041-6061-100101-170

attemptsintegerrequired

min 0 · max 9007199254740991

successintegerrequired

min 0 · max 9007199254740991

pctnumber | nullrequired

checkoutVisitsintegerrequired

min 0 · max 9007199254740991

bustsintegerrequired

min 0 · max 9007199254740991

bustPctnumber | nullrequired

finishLengthobjectrequired

Show properties

oneDartintegerrequired

min 0 · max 9007199254740991

twoDartintegerrequired

min 0 · max 9007199254740991

threeDartintegerrequired

min 0 · max 9007199254740991

longFinishobject[]required

Show properties

Array of object

thresholdstringrequired

Allowed:170100+130+150+

attemptsintegerrequired

min 0 · max 9007199254740991

successintegerrequired

min 0 · max 9007199254740991

pctnumber | nullrequired

doublesobjectrequired

Show properties

overallobjectrequired

Show properties

attemptsintegerrequired

min 0 · max 9007199254740991

hitsintegerrequired

min 0 · max 9007199254740991

hitPctnumber | nullrequired

costPerDoublenumber | nullrequired

perDoubleobject[]required

Show properties

Array of object

doubleintegerrequired

min -9007199254740991 · max 9007199254740991

labelstringrequired

attemptsintegerrequired

min 0 · max 9007199254740991

hitsintegerrequired

min 0 · max 9007199254740991

hitPctnumber | nullrequired

costPerDoublenumber | nullrequired

weakestobject[]required

Show properties

Array of object

doubleintegerrequired

min -9007199254740991 · max 9007199254740991

labelstringrequired

attemptsintegerrequired

min 0 · max 9007199254740991

hitsintegerrequired

min 0 · max 9007199254740991

hitPctnumber | nullrequired

costPerDoublenumber | nullrequired

strongestobject[]required

Show properties

Array of object

doubleintegerrequired

min -9007199254740991 · max 9007199254740991

labelstringrequired

attemptsintegerrequired

min 0 · max 9007199254740991

hitsintegerrequired

min 0 · max 9007199254740991

hitPctnumber | nullrequired

costPerDoublenumber | nullrequired

leavesobjectrequired

Show properties

perDoubleobject[]required

Show properties

Array of object

doubleintegerrequired

min -9007199254740991 · max 9007199254740991

labelstringrequired

leavesintegerrequired

min 0 · max 9007199254740991

conversionsintegerrequired

min 0 · max 9007199254740991

conversionPctnumber | nullrequired

mostLeftobject[]required

Show properties

Array of object

doubleintegerrequired

min -9007199254740991 · max 9007199254740991

labelstringrequired

leavesintegerrequired

min 0 · max 9007199254740991

conversionsintegerrequired

min 0 · max 9007199254740991

conversionPctnumber | nullrequired

checkoutPointsAvgnumber | nullrequired

bestCheckoutnumber | nullrequired

count60Plusintegerrequired

min 0 · max 9007199254740991

count100Plusintegerrequired

min 0 · max 9007199254740991

count140Plusintegerrequired

min 0 · max 9007199254740991

count170Plusintegerrequired

min 0 · max 9007199254740991

count180integerrequired

min 0 · max 9007199254740991

count100PlusCheckoutsintegerrequired

min 0 · max 9007199254740991

previousobject | nullrequired

Show properties

Any of:

object

legsPlayedintegerrequired

min 0 · max 9007199254740991

legsWonintegerrequired

min 0 · max 9007199254740991

threeDartAvgnumber | nullrequired

first9Avgnumber | nullrequired

avgUntil170number | nullrequired

checkoutAttemptsintegerrequired

min 0 · max 9007199254740991

checkoutSuccessintegerrequired

min 0 · max 9007199254740991

checkoutPctnumber | nullrequired

checkoutByBandobject[]required

Show properties

Array of object

bandstringrequired

Allowed:2-4041-6061-100101-170

attemptsintegerrequired

min 0 · max 9007199254740991

successintegerrequired

min 0 · max 9007199254740991

pctnumber | nullrequired

checkoutVisitsintegerrequired

min 0 · max 9007199254740991

bustsintegerrequired

min 0 · max 9007199254740991

bustPctnumber | nullrequired

finishLengthobjectrequired

Show properties

oneDartintegerrequired

min 0 · max 9007199254740991

twoDartintegerrequired

min 0 · max 9007199254740991

threeDartintegerrequired

min 0 · max 9007199254740991

longFinishobject[]required

Show properties

Array of object

thresholdstringrequired

Allowed:170100+130+150+

attemptsintegerrequired

min 0 · max 9007199254740991

successintegerrequired

min 0 · max 9007199254740991

pctnumber | nullrequired

doublesobjectrequired

Show properties

overallobjectrequired

Show properties

attemptsintegerrequired

min 0 · max 9007199254740991

hitsintegerrequired

min 0 · max 9007199254740991

hitPctnumber | nullrequired

costPerDoublenumber | nullrequired

perDoubleobject[]required

Show properties

Array of object

doubleintegerrequired

min -9007199254740991 · max 9007199254740991

labelstringrequired

attemptsintegerrequired

min 0 · max 9007199254740991

hitsintegerrequired

min 0 · max 9007199254740991

hitPctnumber | nullrequired

costPerDoublenumber | nullrequired

weakestobject[]required

Show properties

Array of object

doubleintegerrequired

min -9007199254740991 · max 9007199254740991

labelstringrequired

attemptsintegerrequired

min 0 · max 9007199254740991

hitsintegerrequired

min 0 · max 9007199254740991

hitPctnumber | nullrequired

costPerDoublenumber | nullrequired

strongestobject[]required

Show properties

Array of object

doubleintegerrequired

min -9007199254740991 · max 9007199254740991

labelstringrequired

attemptsintegerrequired

min 0 · max 9007199254740991

hitsintegerrequired

min 0 · max 9007199254740991

hitPctnumber | nullrequired

costPerDoublenumber | nullrequired

leavesobjectrequired

Show properties

perDoubleobject[]required

Show properties

Array of object

doubleintegerrequired

min -9007199254740991 · max 9007199254740991

labelstringrequired

leavesintegerrequired

min 0 · max 9007199254740991

conversionsintegerrequired

min 0 · max 9007199254740991

conversionPctnumber | nullrequired

mostLeftobject[]required

Show properties

Array of object

doubleintegerrequired

min -9007199254740991 · max 9007199254740991

labelstringrequired

leavesintegerrequired

min 0 · max 9007199254740991

conversionsintegerrequired

min 0 · max 9007199254740991

conversionPctnumber | nullrequired

checkoutPointsAvgnumber | nullrequired

bestCheckoutnumber | nullrequired

count60Plusintegerrequired

min 0 · max 9007199254740991

count100Plusintegerrequired

min 0 · max 9007199254740991

count140Plusintegerrequired

min 0 · max 9007199254740991

count170Plusintegerrequired

min 0 · max 9007199254740991

count180integerrequired

min 0 · max 9007199254740991

count100PlusCheckoutsintegerrequired

min 0 · max 9007199254740991

null

null

object

gameTypestringrequired

windowintegerrequired

min -9007199254740991 · max 9007199254740991

lifetimePlayerLifetimeStatsrequired

Show properties

legsPlayedintegerrequired

min 0 · max 9007199254740991

winRatePlayednumberrequired

winRateWonnumberrequired

threeDartAvgnumber | null

summaryobjectrequired

Show properties

legsPlayedintegerrequired

min 0 · max 9007199254740991

legsWonintegerrequired

min 0 · max 9007199254740991

marksPerRoundnumber | nullrequired

first9MarksAvgnumber | nullrequired

pointsintegerrequired

min -9007199254740991 · max 9007199254740991

count5Marksintegerrequired

min 0 · max 9007199254740991

count6Marksintegerrequired

min 0 · max 9007199254740991

count7Marksintegerrequired

min 0 · max 9007199254740991

count8Marksintegerrequired

min 0 · max 9007199254740991

count9Marksintegerrequired

min 0 · max 9007199254740991

countWhiteHorseintegerrequired

min 0 · max 9007199254740991

previousobject | nullrequired

Show properties

Any of:

object

legsPlayedintegerrequired

min 0 · max 9007199254740991

legsWonintegerrequired

min 0 · max 9007199254740991

marksPerRoundnumber | nullrequired

first9MarksAvgnumber | nullrequired

pointsintegerrequired

min -9007199254740991 · max 9007199254740991

count5Marksintegerrequired

min 0 · max 9007199254740991

count6Marksintegerrequired

min 0 · max 9007199254740991

count7Marksintegerrequired

min 0 · max 9007199254740991

count8Marksintegerrequired

min 0 · max 9007199254740991

count9Marksintegerrequired

min 0 · max 9007199254740991

countWhiteHorseintegerrequired

min 0 · max 9007199254740991

null

null

object

gameTypestringrequired

windowintegerrequired

min -9007199254740991 · max 9007199254740991

lifetimePlayerLifetimeStatsrequired

Show properties

legsPlayedintegerrequired

min 0 · max 9007199254740991

winRatePlayednumberrequired

winRateWonnumberrequired

threeDartAvgnumber | null

summaryobjectrequired

Show properties

legsPlayedintegerrequired

min 0 · max 9007199254740991

legsWonintegerrequired

min 0 · max 9007199254740991

dartsPerGamenumber | nullrequired

livesGainedPerGamenumber | nullrequired

livesLostPerGamenumber | nullrequired

killsPerGamenumber | nullrequired

totalDartsintegerrequired

min 0 · max 9007199254740991

totalKillsintegerrequired

min 0 · max 9007199254740991

totalLivesGainedintegerrequired

min 0 · max 9007199254740991

totalLivesLostintegerrequired

min 0 · max 9007199254740991

bestKillsinteger | nullrequired

Show properties

Any of:

integer

integer

null

null

previousobject | nullrequired

Show properties

Any of:

object

legsPlayedintegerrequired

min 0 · max 9007199254740991

legsWonintegerrequired

min 0 · max 9007199254740991

dartsPerGamenumber | nullrequired

livesGainedPerGamenumber | nullrequired

livesLostPerGamenumber | nullrequired

killsPerGamenumber | nullrequired

totalDartsintegerrequired

min 0 · max 9007199254740991

totalKillsintegerrequired

min 0 · max 9007199254740991

totalLivesGainedintegerrequired

min 0 · max 9007199254740991

totalLivesLostintegerrequired

min 0 · max 9007199254740991

bestKillsinteger | nullrequired

Show properties

Any of:

integer

integer

null

null

null

null

object

gameTypestringrequired

windowintegerrequired

min -9007199254740991 · max 9007199254740991

lifetimePlayerLifetimeStatsrequired

Show properties

legsPlayedintegerrequired

min 0 · max 9007199254740991

winRatePlayednumberrequired

winRateWonnumberrequired

threeDartAvgnumber | null

summaryobjectrequired

Show properties

legsPlayedintegerrequired

min 0 · max 9007199254740991

legsWonintegerrequired

min 0 · max 9007199254740991

marksPerRoundnumber | nullrequired

buildingsPerGamenumber | nullrequired

killsPerGamenumber | nullrequired

deathsPerGamenumber | nullrequired

dartsPerGamenumber | nullrequired

bullseyePerGamenumber | nullrequired

kdRationumber | nullrequired

totalDartsintegerrequired

min 0 · max 9007199254740991

totalBuildingsintegerrequired

min 0 · max 9007199254740991

totalKillsintegerrequired

min 0 · max 9007199254740991

totalDeathsintegerrequired

min 0 · max 9007199254740991

totalBullseyeCapturesintegerrequired

min 0 · max 9007199254740991

bestKillsinteger | nullrequired

Show properties

Any of:

integer

integer

null

null

count5Marksintegerrequired

min 0 · max 9007199254740991

count6Marksintegerrequired

min 0 · max 9007199254740991

count7Marksintegerrequired

min 0 · max 9007199254740991

count8Marksintegerrequired

min 0 · max 9007199254740991

count9Marksintegerrequired

min 0 · max 9007199254740991

previousobject | nullrequired

Show properties

Any of:

object

legsPlayedintegerrequired

min 0 · max 9007199254740991

legsWonintegerrequired

min 0 · max 9007199254740991

marksPerRoundnumber | nullrequired

buildingsPerGamenumber | nullrequired

killsPerGamenumber | nullrequired

deathsPerGamenumber | nullrequired

dartsPerGamenumber | nullrequired

bullseyePerGamenumber | nullrequired

kdRationumber | nullrequired

totalDartsintegerrequired

min 0 · max 9007199254740991

totalBuildingsintegerrequired

min 0 · max 9007199254740991

totalKillsintegerrequired

min 0 · max 9007199254740991

totalDeathsintegerrequired

min 0 · max 9007199254740991

totalBullseyeCapturesintegerrequired

min 0 · max 9007199254740991

bestKillsinteger | nullrequired

Show properties

Any of:

integer

integer

null

null

count5Marksintegerrequired

min 0 · max 9007199254740991

count6Marksintegerrequired

min 0 · max 9007199254740991

count7Marksintegerrequired

min 0 · max 9007199254740991

count8Marksintegerrequired

min 0 · max 9007199254740991

count9Marksintegerrequired

min 0 · max 9007199254740991

null

null

object

gameTypestringrequired

windowintegerrequired

min -9007199254740991 · max 9007199254740991

lifetimePlayerLifetimeStatsrequired

Show properties

legsPlayedintegerrequired

min 0 · max 9007199254740991

winRatePlayednumberrequired

winRateWonnumberrequired

threeDartAvgnumber | null

summaryobjectrequired

Show properties

legsPlayedintegerrequired

min 0 · max 9007199254740991

legsWonintegerrequired

min 0 · max 9007199254740991

marksPerRoundnumber | nullrequired

scorePerGamenumber | nullrequired

totalPointsintegerrequired

min -9007199254740991 · max 9007199254740991

totalHammersintegerrequired

min 0 · max 9007199254740991

hammersPerGamenumber | nullrequired

bestRoundinteger | nullrequired

Show properties

Any of:

integer

integer

null

null

bestScoreinteger | nullrequired

Show properties

Any of:

integer

integer

null

null

count5Marksintegerrequired

min 0 · max 9007199254740991

count6Marksintegerrequired

min 0 · max 9007199254740991

count7Marksintegerrequired

min 0 · max 9007199254740991

count8Marksintegerrequired

min 0 · max 9007199254740991

count9Marksintegerrequired

min 0 · max 9007199254740991

previousobject | nullrequired

Show properties

Any of:

object

legsPlayedintegerrequired

min 0 · max 9007199254740991

legsWonintegerrequired

min 0 · max 9007199254740991

marksPerRoundnumber | nullrequired

scorePerGamenumber | nullrequired

totalPointsintegerrequired

min -9007199254740991 · max 9007199254740991

totalHammersintegerrequired

min 0 · max 9007199254740991

hammersPerGamenumber | nullrequired

bestRoundinteger | nullrequired

Show properties

Any of:

integer

integer

null

null

bestScoreinteger | nullrequired

Show properties

Any of:

integer

integer

null

null

count5Marksintegerrequired

min 0 · max 9007199254740991

count6Marksintegerrequired

min 0 · max 9007199254740991

count7Marksintegerrequired

min 0 · max 9007199254740991

count8Marksintegerrequired

min 0 · max 9007199254740991

count9Marksintegerrequired

min 0 · max 9007199254740991

null

null

400

Invalid request.

messagestringrequired

401

Missing or invalid API key.

messagestringrequired

403

The API key is missing a required scope or is the wrong type for this endpoint.

messagestringrequired

404

Entity not found.

messagestringrequired

429

Rate limit exceeded. See the Retry-After header.

messagestringrequired

500

Internal server error.

messagestringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

API keyRemember on this deviceInclude my values in samples

Parameters

idpath*The entity id.gameTypequery*The game type to report.windowqueryLegs to include: `auto` (a bounded default), `all`, or an explicit count from 1 to 1000.modequeryOptional mode filter for hammer cricket.

Request

curl -X GET 'https://api.dartpilot.app/v1/players/string/statistics?gameType=x01' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'

const response = await fetch("https://api.dartpilot.app/v1/players/string/statistics?gameType=x01", {
  method: "GET",
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://api.dartpilot.app/v1/players/string/statistics?gameType=x01",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json"
    },
)

Response

{
  "gameType": "x01",
  "window": -9007199254740991,
  "lifetime": {
    "legsPlayed": 0,
    "winRatePlayed": 0,
    "winRateWon": 0,
    "threeDartAvg": 0
  },
  "tier": {
    "id": "starter",
    "label": "string",
    "minAvg": 0,
    "description": "string",
    "metallic": true
  },
  "summary": {
    "legsPlayed": 0,
    "legsWon": 0,
    "threeDartAvg": 0,
    "first9Avg": 0,
    "avgUntil170": 0,
    "checkoutAttempts": 0,
    "checkoutSuccess": 0,
    "checkoutPct": 0,
    "checkoutByBand": [
      {
        "band": "2-40",
        "attempts": 0,
        "success": 0,
        "pct": 0
      }
    ],
    "checkoutVisits": 0,
    "busts": 0,
    "bustPct": 0,
    "finishLength": {
      "oneDart": 0,
      "twoDart": 0,
      "threeDart": 0
    },
    "longFinish": [
      {
        "threshold": "170",
        "attempts": 0,
        "success": 0,
        "pct": 0
      }
    ],
    "doubles": {
      "overall": {
        "attempts": 0,
        "hits": 0,
        "hitPct": 0,
        "costPerDouble": 0
      },
      "perDouble": [
        {
          "double": -9007199254740991,
          "label": "string",
          "attempts": 0,
          "hits": 0,
          "hitPct": 0,
          "costPerDouble": 0
        }
      ],
      "weakest": [
        {
          "double": -9007199254740991,
          "label": "string",
          "attempts": 0,
          "hits": 0,
          "hitPct": 0,
          "costPerDouble": 0
        }
      ],
      "strongest": [
        {
          "double": -9007199254740991,
          "label": "string",
          "attempts": 0,
          "hits": 0,
          "hitPct": 0,
          "costPerDouble": 0
        }
      ]
    },
    "leaves": {
      "perDouble": [
        {
          "double": -9007199254740991,
          "label": "string",
          "leaves": 0,
          "conversions": 0,
          "conversionPct": 0
        }
      ],
      "mostLeft": [
        {
          "double": -9007199254740991,
          "label": "string",
          "leaves": 0,
          "conversions": 0,
          "conversionPct": 0
        }
      ]
    },
    "checkoutPointsAvg": 0,
    "bestCheckout": 0,
    "count60Plus": 0,
    "count100Plus": 0,
    "count140Plus": 0,
    "count170Plus": 0,
    "count180": 0,
    "count100PlusCheckouts": 0
  },
  "previous": {
    "legsPlayed": 0,
    "legsWon": 0,
    "threeDartAvg": 0,
    "first9Avg": 0,
    "avgUntil170": 0,
    "checkoutAttempts": 0,
    "checkoutSuccess": 0,
    "checkoutPct": 0,
    "checkoutByBand": [
      {
        "band": "2-40",
        "attempts": 0,
        "success": 0,
        "pct": 0
      }
    ],
    "checkoutVisits": 0,
    "busts": 0,
    "bustPct": 0,
    "finishLength": {
      "oneDart": 0,
      "twoDart": 0,
      "threeDart": 0
    },
    "longFinish": [
      {
        "threshold": "170",
        "attempts": 0,
        "success": 0,
        "pct": 0
      }
    ],
    "doubles": {
      "overall": {
        "attempts": 0,
        "hits": 0,
        "hitPct": 0,
        "costPerDouble": 0
      },
      "perDouble": [
        {
          "double": -9007199254740991,
          "label": "string",
          "attempts": 0,
          "hits": 0,
          "hitPct": 0,
          "costPerDouble": 0
        }
      ],
      "weakest": [
        {
          "double": -9007199254740991,
          "label": "string",
          "attempts": 0,
          "hits": 0,
          "hitPct": 0,
          "costPerDouble": 0
        }
      ],
      "strongest": [
        {
          "double": -9007199254740991,
          "label": "string",
          "attempts": 0,
          "hits": 0,
          "hitPct": 0,
          "costPerDouble": 0
        }
      ]
    },
    "leaves": {
      "perDouble": [
        {
          "double": -9007199254740991,
          "label": "string",
          "leaves": 0,
          "conversions": 0,
          "conversionPct": 0
        }
      ],
      "mostLeft": [
        {
          "double": -9007199254740991,
          "label": "string",
          "leaves": 0,
          "conversions": 0,
          "conversionPct": 0
        }
      ]
    },
    "checkoutPointsAvg": 0,
    "bestCheckout": 0,
    "count60Plus": 0,
    "count100Plus": 0,
    "count140Plus": 0,
    "count170Plus": 0,
    "count180": 0,
    "count100PlusCheckouts": 0
  }
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}