---
title: "Get player summary by player id"
method: GET
path: "/football/players/{id}"
tags: ["Football.Players"]
---

# Get player summary by player id

`GET /football/players/{id}`

## Request

- Base URL: `https://sports.highlightly.net`
- URL: `https://sports.highlightly.net/football/players/{id}`
- Auth: none declared. Required headers: `x-rapidapi-host`, `x-rapidapi-key`
- TypeScript: <https://skmtc.dev/highlightly/apis/sports-api-highlightly/docs/football/players/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

> Refresh interval: Once a day

Retrieve detailed player summary for specified `playerId`.

Detailed player summary consists of the following information:

| Type         | Description |
| ------------ | ----------- |
| Profile      | Provides a structured summary of a football player's personal and professional profile. It includes key details such as current club affiliation, contract timelines, physical attributes (height, preferred foot), biographical data (name, birth date, birthplace, citizenship), and playing positions. The data reflects both the player's current career status and positional versatility, offering a higher level overview which is useful for scouting, analysis, or profile display. |
| Rumours      | Rumours field provides an overview of a football player's transfer rumours. It distinguishes between current and historical speculation. Each entry includes the date the rumour emerged and, when available, a transfer probability indicating the estimated likelihood of the move. This data helps track the player's visibility and perceived value in the transfer market over time. |
| Related news | Contains a list of news articles related to a football player, offering a historical record of media coverage. Each entry includes the article's title, publication date, and a link to the full content. The topics span various aspects of the player's career and broader football developments, including transfer moves, international appearances, squad analysis, and club strategies. This data helps illustrate the player's visibility in the media and contextualizes their role within the football landscape over time. |
| Transfers    | Outlines the complete transfer history of a football player, detailing their movement between clubs over the course of their career. Each entry includes the destination and origin clubs, the type of transfer (such as transfer, loan, or end of loan), the season in which the move occurred, the player's market value at the time, and the transfer fee when applicable. Transfer history provides us with a comprehensive view of the players mobility, market trajectory, and contractual developments across multiple leagues and stages of their career. |
| Market value | Presents a chronological record of a football players market value over time. Each entry includes the recorded date, market value, players club at the time, age, and currency. This data allows for analysis of value trends throughout the players career, reflecting factors such as performance, injuries, transfers, and broader market conditions. It is useful for scouting, valuation modelling, and historical comparisons. |

Below is an example of what you can aim to achieve with the player summary endpoint:

![Player summary example](https://highlightly.net/assets/img/documentation/football/player-details.png)

## Path parameters

- `id` number, required

## Headers

- `x-rapidapi-host` string, required
- `x-rapidapi-key` string, required

## Response `200`

- FootballDetailedPlayerSummaryResponseDto[]
  - `id` number, required
  - `name` string, required
  - `fullName` string
  - `logo` string
  - `profile` FootballDetailedPlayerSummaryProfileDto
    - `fullName` string
    - `birthDate` string
    - `deathDate` string
    - `birthPlace` string
    - `citizenship` string
    - `foot` string
    - `height` string
    - `position` FootballDetailedPlayerSummaryPositionDto, required
      - `main` string
      - `secondary` string
    - `club` FootballDetailedPlayerSummaryClubDto, required
      - `current` string
      - `joinedAt` string
      - `contractExpiry` string
      - `latestContractExtension` string
  - `rumours` FootballDetailedPlayerSummaryRumoursDto, required
    - `current` FootballDetailedPlayerSummaryRumourDto[], required
      - `club` string, required
      - `rumourDate` string, required
      - `transferProbability` string, required
    - `historical` FootballDetailedPlayerSummaryRumourDto[], required
      - `club` string, required
      - `rumourDate` string, required
      - `transferProbability` string, required
  - `relatedNews` FootballDetailedPlayerSummaryRelatedNewsDto[], required
    - `url` string, required
    - `date` string, required
    - `title` string, required
  - `transfers` FootballDetailedPlayerSummaryTransfersDto[], required
    - `to` string, required
    - `fee` string
    - `from` string, required
    - `type` 'transfer' | 'loan' | 'end of loan' | 'retired', required
    - `season` string, required
    - `marketValue` string
    - `transferDate` string, required
  - `marketValue` FootballDetailedPlayerMarketValuesDto[], required
    - `recordedDate` string, required
    - `club` string, required
    - `value` number, required
    - `age` number, required
    - `currency` string, required
  - `injuries` FootballDetailedPlayerInjuriesDto[], required
    - `reason` string, required
    - `season` string, required
    - `fromDate` string, required
    - `toDate` string, required
    - `missedGames` number, required
    - `absentDurationInDays` number

## Other responses

- `400`: Bad request descriptive error.
- `500`: Internal server error.

---

[API](https://skmtc.dev/highlightly/apis/sports-api-highlightly.md) - [All operations](https://skmtc.dev/highlightly/apis/sports-api-highlightly/llms.txt) - [OpenAPI document](https://skmtc.dev/highlightly/apis/sports-api-highlightly/revisions/c8a366d3091f?raw)