Acccount - Change your Gamertag

class xbox.webapi.api.provider.account.AccountProvider(client)[source]

Bases: BaseProvider

BASE_URL_USER_MGT = 'https://user.mgt.xboxlive.com'
BASE_URL_ACCOUNT = 'https://accounts.xboxlive.com'
HEADERS_USER_MGT = {'x-xbl-contract-version': '1'}
HEADERS_ACCOUNT = {'x-xbl-contract-version': '2'}
async claim_gamertag(xuid, gamertag, **kwargs)[source]

Claim gamertag

XLE error codes:

400 - Bad API request 401 - Unauthorized 409 - Gamertag unavailable 429 - Too many requests 200 - Gamertag available

Parameters:

  • xuid (int) – Your xuid as integer

  • gamertag (str) – Desired gamertag

Return type:

ClaimGamertagResult

Returns: ClaimGamertagResult

async change_gamertag(xuid, gamertag, preview=False, **kwargs)[source]

Change your gamertag.

XLE error codes:

200 - success 1020 - No free gamertag changes available

Parameters:

  • xuid (int) – Your Xuid as integer

  • gamertag (str) – Desired gamertag name

  • preview (bool) – Preview the change

Return type:

ChangeGamertagResult

Returns: ChangeGamertagResult