---
search:
  tags:
    - Players
    - GET
seo:
  description: >-
    Lists a player's completed games, newest first, limited to games the key…
    Reference for the GET /players/{id}/games endpoint in the dartpilot Public
    API.
sidebar:
  label: List a player's recent games
  badge: GET
title: List a player's recent games
type: openapi-operation
---
Lists a player's completed games, newest first, limited to games the key owner may view. The target must be the API key owner or an accepted friend. Campaign games are excluded, matching the app's recent-games list.

`GET /players/{id}/games`

**Responses**

- `200` — A page of games.
- `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
{
  "items": [
    {
      "id": "string",
      "type": "string",
      "status": "string",
      "createdAt": "string",
      "updatedAt": "string",
      "result": "win",
      "ranked": true,
      "players": [
        {
          "name": "string",
          "userId": "string",
          "isAi": true,
          "aiLevel": -9007199254740991
        }
      ]
    }
  ],
  "paging": {
    "nextCursor": "string"
  }
}
```