---
search:
  tags:
    - Players
    - GET
seo:
  description: >-
    Returns a day- or week-bucketed trend for one game type: legs, win rate and…
    Reference for the GET /players/{id}/trend endpoint in the dartpilot Public
    API.
sidebar:
  label: Get a player's game trend
  badge: GET
title: Get a player's game trend
type: openapi-operation
---
Returns a day- or week-bucketed trend for one game type: legs, win rate and the game's headline metric. Reads the daily rollup, so it stays cheap for long histories. The target must be the key owner or an accepted friend.

`GET /players/{id}/trend`

**Responses**

- `200` — The player trend.
- `400` — Invalid request.
- `401` — Missing or invalid API key.
- `403` — The API key is missing a required scope or is the wrong type for this endpoint.
- `404` — Entity not found.
- `429` — Rate limit exceeded. See the \`Retry-After\` header.
- `500` — Internal server error.

Response example, 200:

```json
{
  "gameType": "x01",
  "metricLabel": "string",
  "granularity": "day",
  "days": -9007199254740991,
  "points": [
    {
      "period": "string",
      "legsPlayed": 0,
      "legsWon": 0,
      "rankedLegs": 0,
      "rankedLegsWon": 0,
      "winRatePct": 0,
      "primaryMetric": 0
    }
  ]
}
```