---
title: "Athlete Chart Events"
method: GET
path: "/athletes/chartEvents"
tags: ["Athletes"]
---

# Athlete Chart Events

`GET /athletes/chartEvents`

Get shot and goal event data with xG statistics, goal zones, and penalty conversion data for a specific athlete

## Query parameters

- `athletes` integer, required

## Response `200`

Athlete chart events retrieved successfully

- object
  - `chartEvents` object[] — Chart events data for the athlete
    - `athleteId` integer — Athlete ID
    - `mostCommonGoalZone` string[] — Most common goal zones
    - `penaltyGoals` string — Penalty goals ratio (e.g., '3/4')
    - `penaltyConversions` string — Penalty conversion percentage
    - `events` object[] — Shot/goal events with xG data
      - `xg` string — Expected goals value
      - `xgot` string — Expected goals on target
      - `bodyPart` string — Body part used
      - `goalDescription` string — Goal zone description
      - `time` string — Event minute
      - `gameId` integer — Game ID
      - `line` number — Pitch vertical position
      - `side` number — Pitch horizontal position
      - `outcome` object — Shot outcome
        - `id` integer — Outcome ID (0=Goal, 1=Blocked, 2=Saved, 3=Off Target)
        - `name` string
        - `y` number
        - `z` number
  - `athletes` unknown[] — Athlete information
    - unknown
  - `games` unknown[] — Referenced games
    - unknown
  - `competitions` unknown[] — Referenced competitions
    - unknown

## Other responses

- `400` — Missing required parameter: athletes

---

[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)