Season Transfers

get

https://api.sportradar.com/soccer/{access_level}/v4/{language_code}/seasons/{season_id}/transfers.{format}

Provides a list of all player transfers for a given season.

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
Update Frequency
300s Time To Live / Cache

Data Points

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`transfer` - `competitors` - `competitor`	String	Abbreviation for a competitor name ex. `LIV` (Liverpool FC)
`age_group`	`transfer` - `competitors` - `competitor`	String	Age group of a competitor, when applicable ex. `U23`
`country`	`transfer` - `competitors` - `competitor`	String	Country of a competitor ex. `England`
`country_code`	`transfer` - `competitors` - `competitor`	String	Country code of a competitor ex. `ENG` (England)
`gender`	`transfer` - `competitors` - `competitor`	String	Gender for a competitor `male`, `female`
`id`	`transfer` - `competitors` - `competitor`	String	Unique ID for a competitor ex. `sr:competitor:44` (Liverpool FC)
`name`	`transfer` - `competitors` - `competitor`	String	Name for a competitor ex. `Liverpool FC`
`virtual`	`transfer` - `competitors` - `competitor`	Boolean	Signifies a competitor is a virtual team when `true`. Used for placeholder teams in TBD vs TBD matchups.

Player

Attribute	Parent Element	Type	Description
`country_code`	`transfer` - `player`	String	Country code of a player ex. `EGY` (Egypt)
`date_of_birth`	`transfer` - `player`	Date	Date of birth of a player ex. `1992-06-15`
`gender`	`transfer` - `player`	String	Gender of a player `male`, `female`
`height`	`transfer` - `player`	Integer	Height of a player in centimeters ex. `175`
`id`	`transfer` - `player`	String	Unique ID of a player ex. `sr:player:159665`
`jersey_number`	`transfer` - `player`	Integer	Jersey number of a player
`name`	`transfer` - `player`	String	Name of a player ex. `Salah, Mohamed`
`nationality`	`transfer` - `player`	String	Nationality of a player ex. `Egypt`
`nickname`	`transfer` - `player`	String	Nickname of a player
`place_of_birth`	`transfer` - `player`	String	Place of birth of a player ex. `Basyoun, El Gharbia`
`preferred_foot`	`transfer` - `player`	String	Preferred foot of a player `left`, `right`
`type`	`transfer` - `player`	String	Position of a player `goalkeeper`, `defender`, `midfielder`, `forward`
`weight`	`transfer` - `player`	Integer	Weight of a player in kilograms ex. `71`

Transfer

Attribute	Parent Element	Type	Description
`transfer_date`	`transfer`	Date	Transfer date of a player transfer ex. `2024-02-01`
`role_type`	`transfer`	String	Player's role for transfer `player`, `manager`, `on_loan`, `unemployed`, `other`
`from_competitor`	`transfer`	String	Unique ID of the competitor a player transferred from ex. `sr:competitor:2383`
`to_competitor`	`transfer`	String	Unique ID of the competitor a player transferred to ex. `sr:competitor:2383`

Path Params

access_level

string

enum

required

Defaults to trial

The access level of your API key

trial, production

Allowed:

language_code

string

enum

required

Defaults to en

2-letter code for supported languages

da (Danish), de (German), el (Greek), en (English), es (Spanish), fi (Finnish), fr (French), id (Indonesian), it (Italian), ja (Japanese), nl (Dutch), pt (Portuguese), ru (Russian), sr (Serbian), srl (Serbian Latin), th (Thai), tr (Turkish), zh (Chinese - simplified), zht (Chinese - traditional)

The above codes are the fully supported languages for this API. Click here for valid language codes and a tabular list of available languages per competition.

season_id

string

required

Defaults to sr:season:130281

Unique Id of a season, found in the Seasons endpoint

Note: The API provides a maximum of 3 seasons per competition — 2 previous seasons and 1 current season.

Example: sr:season:118689

format

string

enum

required

Defaults to json

Format returned

json, xml

Allowed:

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json