> ## Documentation Index
> Fetch the complete documentation index at: https://docs.novig.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Player Queries

> Query player information, stats, and team rosters

## Player Aggregation

Access player data through the event, game, competitor, and player relationship hierarchy.

### Data Hierarchy

<Steps>
  <Step title="Event">
    Top-level object representing a game (e.g., "KC Chiefs vs BUF Bills - Week 14")
  </Step>

  <Step title="Game">
    Contains start time, league, and competitors
  </Step>

  <Step title="Competitors">
    Home and away teams with their rosters
  </Step>

  <Step title="Players">
    Individual players with stats and positions
  </Step>
</Steps>

## Example Query

```graphql theme={null}
query EventPlayers($eventId: ID!) {
  event(id: $eventId) {
    id
    description
    game {
      id
      startTime
      homeCompetitor {
        id
        name
        players {
          id
          name
          number
          position
          stats {
            rushingYards
            passingYards
            receptions
          }
        }
      }
      awayCompetitor {
        id
        name
        players {
          id
          name
          number
          position
          stats {
            rushingYards
            passingYards
            receptions
          }
        }
      }
    }
  }
}
```

### Variables

```json theme={null}
{
  "eventId": "123e4567-e89b-12d3-a456-426614174001"
}
```

### Example Response

```json theme={null}
{
  "data": {
    "event": {
      "id": "123e4567-e89b-12d3-a456-426614174001",
      "description": "KC Chiefs vs BUF Bills - Week 14",
      "game": {
        "id": "game-001",
        "startTime": "2023-12-10T20:00:00Z",
        "homeCompetitor": {
          "id": "team-buf",
          "name": "Buffalo Bills",
          "players": [
            {
              "id": "player-001",
              "name": "Josh Allen",
              "number": "17",
              "position": "QB",
              "stats": {
                "rushingYards": 45,
                "passingYards": 275,
                "receptions": 0
              }
            }
          ]
        },
        "awayCompetitor": {
          "id": "team-kc",
          "name": "Kansas City Chiefs",
          "players": [
            {
              "id": "player-002",
              "name": "Patrick Mahomes",
              "number": "15",
              "position": "QB",
              "stats": {
                "rushingYards": 30,
                "passingYards": 298,
                "receptions": 0
              }
            }
          ]
        }
      }
    }
  }
}
```

## Field Reference

### Event Fields

| Field         | Type   | Description                      |
| ------------- | ------ | -------------------------------- |
| `id`          | ID     | Unique event identifier          |
| `description` | String | Human-readable event description |
| `game`        | Game   | Associated game details          |

### Game Fields

| Field            | Type       | Description                |
| ---------------- | ---------- | -------------------------- |
| `id`             | ID         | Unique game identifier     |
| `startTime`      | DateTime   | Scheduled start time (UTC) |
| `homeCompetitor` | Competitor | Home team details          |
| `awayCompetitor` | Competitor | Away team details          |

### Competitor Fields

| Field     | Type      | Description                    |
| --------- | --------- | ------------------------------ |
| `id`      | ID        | Unique team identifier         |
| `name`    | String    | Team name                      |
| `players` | \[Player] | Array of players on the roster |

### Player Fields

| Field      | Type        | Description                         |
| ---------- | ----------- | ----------------------------------- |
| `id`       | ID          | Unique player identifier            |
| `name`     | String      | Player name                         |
| `number`   | String      | Jersey number                       |
| `position` | String      | Playing position (QB, RB, WR, etc.) |
| `stats`    | PlayerStats | Player statistics                   |

### PlayerStats Fields

| Field          | Type | Description         |
| -------------- | ---- | ------------------- |
| `rushingYards` | Int  | Total rushing yards |
| `passingYards` | Int  | Total passing yards |
| `receptions`   | Int  | Total receptions    |