> ## 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={"dark"}
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={"dark"}
{
  "eventId": "123e4567-e89b-12d3-a456-426614174001"
}
```

### Example Response

```json theme={"dark"}
{
  "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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.