---
search:
  tags:
    - Players
    - GET
seo:
  description: >-
    Lists the API key owner's accepted friends, online first. Lifetime stats
    come… Reference for the GET /players/me/friends endpoint in the dartpilot
    Public API.
sidebar:
  label: List the key owner's friends
  badge: GET
title: List the key owner's friends
type: openapi-operation
---
Lists the API key owner's accepted friends, online first. Lifetime stats come from the same rollup as the MCP friend tool. `currentLobbyId` and `currentGameId` are only returned when the friend is in a public lobby or public game.

`GET /players/me/friends`

**Responses**

- `200` — A page of friends.
- `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",
      "name": "string",
      "displayName": "string",
      "image": "string",
      "online": true,
      "status": "online",
      "currentLobbyId": "string",
      "currentGameId": "string",
      "gamesPlayed": 0,
      "wins": 0,
      "winRatePct": 0,
      "total180s": 0,
      "lastPlayedAt": "string",
      "lastSeenAt": "string"
    }
  ],
  "paging": {
    "nextCursor": "string"
  }
}
```