Overview

Returns a player’s historical transfer record, including completed transfers, pending transfers, aggregate fee and market-value totals, and related club, coach, and competition IDs. Use it to build a player transfer timeline or summarize career movement.

Inputs

id (string, optional): Transfermarkt player ID. Defaults to 68290 in the endpoint definition. Example: 68290 for Neymar.

Response

The successful response is a JSON object with:

success (boolean): Indicates whether the request succeeded.
message (string): Response message, such as OK.
data (object): Player transfer-history payload containing:
playerId (string)
history.terminated (array): Completed transfer records.
history.pending (array): Pending transfer records; this may be empty.
history.url (string)
history.feeSum (object): Aggregate fee with numeric value, currency, and formatted compact fields.
history.averageAge (number)
history.totalMarketValue (object): Aggregate market value with numeric value, currency, and formatted compact fields.
clubIds, coachIds, and competitionIds (arrays of strings): Related entity IDs.
mostRecentTransfer (object): The latest transfer record.

Each transfer record includes an id, source and destination references, details, typeDetails, and relativeUrl. The details object contains the player ID, transfer date, contract end date, season, pending flag, market value, player age, fee, remaining contract period, and season metadata. Source and destination references can include competition, country, club, and coach IDs.

Auth & browser

Authentication is not required. The endpoint does not require browser context or fetch mode.

Examples

Request

{
  "id": "68290"
}

Success response

The following is a verified response for player ID 68290 (Neymar); the transfer arrays are abbreviated from the returned payload.

{
  "success": true,
  "message": "OK",
  "data": {
    "playerId": "68290",
    "history": {
      "terminated": [
        {
          "id": "5484139",
          "transferSource": {
            "competitionId": "SA1",
            "countryId": 146,
            "clubId": "1114",
            "coachId": "2145"
          },
          "transferDestination": {
            "competitionId": "BRA1",
            "countryId": 26,
            "clubId": "221",
            "coachId": "6175"
          },
          "details": {
            "playerId": "68290",
            "date": "2025-01-31T00:00:00+01:00",
            "contractUntilDate": "2026-12-31T00:00:00+01:00",
            "seasonId": 2024,
            "isPending": false,
            "marketValue": {
              "value": 15000000,
              "currency": "EUR",
              "compact": { "prefix": "€", "content": "15.00", "suffix": "M" }
            },
            "age": 32,
            "fee": {
              "value": null,
              "currency": "",
              "compact": { "prefix": "", "content": "Free Transfer", "suffix": "" }
            },
            "remainingContractPeriod": {
              "days": 150,
              "daysDisplay": "4 Months, 30 Days"
            },
            "season": {
              "id": 2024,
              "display": "24/25",
              "cyclicalName": "2025",
              "nonCyclicalName": "24/25"
            }
          },
          "typeDetails": {
            "type": "STANDARD",
            "name": "",
            "feeDescription": ""
          },
          "relativeUrl": "/neymar/transfers/spieler/68290/transfer_id/5484139"
        }
      ],
      "pending": [],
      "url": "",
      "feeSum": {
        "value": 400000000,
        "currency": "EUR",
        "compact": { "prefix": "€", "content": "400.00", "suffix": "M" }
      },
      "averageAge": 34,
      "totalMarketValue": {
        "value": 8000000,
        "currency": "EUR",
        "compact": { "prefix": "€", "content": "8.00", "suffix": "M" }
      }
    },
    "mostRecentTransfer": {
      "id": "5484139",
      "details": {
        "playerId": "68290",
        "date": "2025-01-31T00:00:00+01:00",
        "seasonId": 2024,
        "isPending": false,
        "age": 32
      },
      "relativeUrl": "/neymar/transfers/spieler/68290/transfer_id/5484139"
    }
  }
}

Notes

terminated contains completed transfer records; pending may be empty.
Fees can be represented as a numeric value or as a formatted label such as Free Transfer, with fee.value set to null.
The response includes relative Transfermarkt URLs; callers may need to prepend the site origin when constructing absolute links.
Arrays such as transfer history and related IDs vary by player. The example shows an abbreviated result.