List a player's recent games

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

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

afterstring

Opaque cursor from the previous page's paging.nextCursor.

limitinteger

Number of items to return per page.

min 1 · max 50 · default: 20

Responses

200

A page of games.

itemsPlayerGame[]required

Show properties

Array of PlayerGame

idstringrequired

typestringrequired

statusstringrequired

createdAtstringrequired

updatedAtstringrequired

resultstringrequired

Allowed:winlossdrawunknown

rankedbooleanrequired

playersobject[]required

Show properties

Array of object

namestringrequired

userIdstring | nullrequired

isAibooleanrequired

aiLevelinteger | nullrequired

Show properties

Any of:

integer

integer

null

null

pagingPagingrequired

Show properties

nextCursorstring | nullrequired

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.afterqueryOpaque cursor from the previous page's `paging.nextCursor`.limitqueryNumber of items to return per page.

Request

curl -X GET 'https://api.dartpilot.app/v1/players/string/games' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'

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

import requests

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

Response

{
  "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"
  }
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}