Overview

Returns a player’s national-team career history. Each record summarizes the player’s appearances for a national side, including games played, goals, shirt number, debut and most recent match details, and current/former career state.

Inputs

id (number, required): Transfermarkt player ID. The verified example uses 68290.

Response

A successful response has the following shape:

success (boolean): Whether the request succeeded.
message (string): Status message, such as OK.
data (object): Result container.
history (array): National-career records. Each item includes:
playerId (string)
clubId (string): National-team or associated club/team identifier.
gamesPlayed (number)
goalsScored (number)
shirtNumber (number)
isCaptain (boolean)
debut (string, ISO date)
debutCoachId (string or null)
debutGameId (string)
lastGame (string, ISO date)
lastGameId (string)
careerState (string), such as RECENTNATIONALPLAYER or FORMERNATIONALPLAYER.
clubIds (array of strings): IDs corresponding to the teams represented in the history.

Auth & browser

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

Examples

Request

{
  "id": 68290
}

Success response

Verified response for player 68290 (the history array is shortened to representative records):

{
  "success": true,
  "message": "OK",
  "data": {
    "history": [
      {
        "playerId": "68290",
        "clubId": "3439",
        "gamesPlayed": 130,
        "goalsScored": 80,
        "shirtNumber": 10,
        "isCaptain": false,
        "debut": "2010-08-10",
        "debutCoachId": "4734",
        "debutGameId": "1043987",
        "lastGame": "2026-07-05",
        "lastGameId": "4776697",
        "careerState": "RECENT_NATIONAL_PLAYER"
      },
      {
        "playerId": "68290",
        "clubId": "7658",
        "gamesPlayed": 7,
        "goalsScored": 9,
        "shirtNumber": 11,
        "isCaptain": false,
        "debut": "2011-01-18",
        "debutCoachId": "4474",
        "debutGameId": "4677595",
        "lastGame": "2011-02-13",
        "lastGameId": "4678365",
        "careerState": "FORMER_NATIONAL_PLAYER"
      }
    ],
    "clubIds": ["3439", "7658", "23130"]
  }
}

Notes

A player can have multiple records, so history and clubIds are variable-length arrays.
debutCoachId may be null when the source does not provide a coach ID.
IDs are returned as strings even though the public input is numeric.
The verified result contains additional history entries beyond the shortened example; consumers should iterate the complete returned arrays.