---
search:
  tags:
    - Games
    - GET
seo:
  description: >-
    Lists active games the key owner may view (their own, a friend's, one they…
    Reference for the GET /games/live endpoint in the dartpilot Public API.
sidebar:
  label: List live games
  badge: GET
title: List live games
type: openapi-operation
---
Lists active games the key owner may view (their own, a friend's, one they participate in, or a public game), most recently active first. Use this instead of polling each game.

`GET /games/live`

**Responses**

- `200` — A page of live 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",
      "kind": "string",
      "startedAt": "string",
      "lastActiveAt": "string",
      "players": [
        {
          "name": "string",
          "userId": "string",
          "image": "string"
        }
      ],
      "boards": [
        "string"
      ]
    }
  ],
  "paging": {
    "nextCursor": "string"
  }
}
```