Transfers

Retrieve player transfer and contract activity for competitors or competitions, including signings, departures, loans, and contract extensions

GET /transfers

List Transfers

cURL

curl --request GET \
  --url https://v1.football.sportsapipro.com/transfers \
  --header 'x-api-key: <api-key>'

Overview

Returns transfer activity including player arrivals, departures, loans, and contract extensions. Each transfer includes athlete details, origin/target clubs, transfer fee (if available), and confirmation status.

Query Parameters

competitors · string

Comma-separated list of competitor IDs to retrieve transfers for. Either competitors or competitions is required.

competitions · string

Comma-separated list of competition IDs to retrieve transfers for. Either competitors or competitions is required.

limit · integer · default: "10"

Maximum number of transfers to return.

onlyConfirmed · boolean · default: "false"

When true, only returns confirmed transfers (excludes rumors).

appTypeId · integer

Application type identifier (resolved automatically).

langId · integer

Language identifier (resolved automatically).

timezoneName · string

Timezone for date/time values (auto-resolved, or specify e.g., America/New_York). All time and contractUntil fields use ISO 8601 format with a dynamic timezone offset.

userCountryId · integer

Country identifier for localization (resolved automatically).

Response Structure

transfers · array

Array of transfer records.

Show Transfer Object

id · integer

Unique transfer identifier.

type · integer

Transfer type:

• 1 - Permanent Transfer
• 2 - Loan
• 3 - Loan Return
• 4 - Free Transfer
• 5 - End of Loan
• 6 - Youth Promotion
• 7 - Released
• 8 - Contract Extension

origin · integer

Origin club/competitor ID.

target · integer

Target/destination club/competitor ID.

time · string

ISO 8601 timestamp of transfer announcement.

price · string

Transfer fee or description (e.g., “€50M”, “Free”, “Contract Extension”, ”-”).

athleteId · integer

ID of the athlete being transferred.

statusId · integer

Status identifier:

• 1 - Rumor
• 2 - Confirmed

statusName · string

Human-readable status (e.g., “Confirmed”, “Rumor”).

positionId · integer

Player position ID:

• 1 - Goalkeeper
• 2 - Defender
• 3 - Midfielder
• 4 - Forward

ImageVersion · integer

Athlete image version number.

isArrival · boolean

Whether this is an incoming transfer for the queried competitor.

isDeparture · boolean

Whether this is an outgoing transfer for the queried competitor.

contractUntil · string

ISO 8601 timestamp of contract end date (for extensions/new signings).

athletes · array

Array of athlete details referenced in transfers.

Show Athlete Object

id · integer

Unique athlete identifier.

name · string

Full athlete name.

shortName · string

Short/display name.

nameForURL · string

URL-safe name slug.

sportId · integer

Sport identifier.

clubId · integer

Current club ID.

clubName · string

Current club name.

nationalityId · integer

Country ID of athlete’s nationality.

imageVersion · integer

Image version for athlete photo.

popularityRank · integer

Popularity ranking score.

createdAt · string

When the athlete record was created.

competitors · array

Array of competitor/club definitions referenced in transfers.

countries · array

Array of country definitions.

sports · array

Array of sport definitions.

Transfer Types

Type ID	Name	Description
1	Permanent Transfer	Standard purchase with transfer fee
2	Loan	Temporary move to another club
3	Loan Return	Player returning from loan
4	Free Transfer	Move without transfer fee (contract expired)
5	End of Loan	Loan period concluded
6	Youth Promotion	Promoted from youth/academy team
7	Released	Contract terminated
8	Contract Extension	Existing contract renewed

Status Values

Status ID	Name	Description
1	Rumor	Unconfirmed transfer speculation
2	Confirmed	Officially announced transfer

Position IDs

Position ID	Name
1	Goalkeeper
2	Defender
3	Midfielder
4	Forward

Example Request

# Get confirmed transfers for Manchester City
curl -X GET "https://v1.football.sportsapipro.com/transfers?competitors=110&limit=5&onlyConfirmed=true" \
  -H "x-api-key: YOUR_API_KEY"

# Get all transfers for Premier League
curl -X GET "https://v1.football.sportsapipro.com/transfers?competitions=7&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

Example Response

{
  "transfers": [
    {
      "id": 346356,
      "type": 8,
      "origin": 110,
      "target": 110,
      "time": "2025-10-03T19:19:28.11",
      "price": "Contract Extension",
      "athleteId": 79620,
      "statusId": 2,
      "statusName": "Confirmed",
      "positionId": 4,
      "ImageVersion": 39,
      "isArrival": true,
      "isDeparture": false,
      "contractUntil": "2031-06-30T16:00:00+00:00"
    },
    {
      "id": 345376,
      "type": 2,
      "origin": 110,
      "target": 945,
      "time": "2025-09-02T14:29:15.59",
      "price": "-",
      "athleteId": 1853,
      "statusId": 2,
      "statusName": "Confirmed",
      "positionId": 3,
      "ImageVersion": 87,
      "isArrival": false,
      "isDeparture": true
    }
  ],
  "athletes": [
    {
      "id": 79620,
      "name": "Savinho",
      "nameForURL": "savinho",
      "sportId": 1,
      "clubId": 110,
      "nationalityId": 21,
      "imageVersion": 39,
      "clubName": "Manchester City"
    },
    {
      "id": 1853,
      "name": "Ilkay Gündoğan",
      "shortName": "Gündoğan",
      "nameForURL": "ilkay-gundogan",
      "sportId": 1,
      "clubId": 945,
      "nationalityId": 4,
      "imageVersion": 87,
      "clubName": "Galatasaray"
    }
  ],
  "competitors": [
    {
      "id": 110,
      "name": "Manchester City",
      "shortName": "Man City",
      "imageVersion": 1,
      "color": "#ABD1F5"
    },
    {
      "id": 945,
      "name": "Galatasaray",
      "imageVersion": 3,
      "color": "#FC8C1A"
    }
  ],
  "countries": [...],
  "sports": [...]
}

Use Cases

• Transfer News: Display latest signings and departures for a club
• Transfer Window Activity: Track all moves during transfer windows
• Contract Tracking: Monitor contract extensions and renewals
• Loan Management: View loan moves in and out
• Rumor Mill: Show unconfirmed transfer speculation (with onlyConfirmed=false)

Notes

• Use onlyConfirmed=true in production to avoid showing unverified rumors
• The isArrival and isDeparture flags are relative to the queried competitor
• For contract extensions, origin and target will be the same club
• The price field may contain fee amounts, descriptions, or ”-” for undisclosed
• Athlete details are provided in the athletes array, linked by athleteId

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

sports · integer

Sport ID (1 = Football)

Example:

1

Response

200

Transfers list retrieved successfully