---
title: "Athlete Game Lineups"
method: GET
path: "/athletes/games/lineups"
tags: ["Athletes"]
---

# Athlete Game Lineups

`GET /athletes/games/lineups`

Get detailed lineup and performance data for a specific athlete in a specific game including stats, heat map, shot chart, and field positioning

## Query parameters

- `athleteId` integer, required
- `gameId` integer, required

## Response `200`

Athlete lineup data retrieved successfully

- object
  - `members` object[] — Lineup member data with stats and positioning
    - `status` integer — Player status (1 = Starting, 2 = Substitute)
    - `statusText` string — Human-readable status
    - `position` object — Player's general position
    - `formation` object — Specific formation role
    - `yardFormation` object — Precise field positioning data
      - `line` integer — Defensive depth line (1-4)
      - `fieldPosition` integer — Position within line
      - `fieldLine` integer — Vertical position %
      - `fieldSide` integer — Horizontal position %
    - `ranking` number — Player match rating (1.0-10.0)
    - `hasHighestRanking` boolean
    - `hasStats` boolean
    - `stats` unknown[] — Performance statistics
      - unknown
    - `heatMap` string — URL to heat map image
    - `hasShotChart` boolean
    - `athleteId` integer
    - `name` string
    - `shortName` string
    - `jerseyNumber` integer
  - `statsCategories` unknown[]
    - unknown
  - `chartEvents` object — Shot chart data with xG
  - `sports` unknown[]
    - unknown
  - `countries` unknown[]
    - unknown
  - `competitions` unknown[]
    - unknown
  - `competitors` unknown[]
    - unknown
  - `games` unknown[]
    - unknown

## Other responses

- `400` — Missing required parameters: athleteId and gameId

---

[API](https://skmtc.net/sportsapipro/apis/sportsapi-pro-football-api.md) · [All operations](https://skmtc.net/sportsapipro/apis/sportsapi-pro-football-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sportsapipro/sportsapi-pro-football-api/revisions/f56c5a94869d/schema)