# GET /lol/summoner/v4/summoners/by-name/{} is deprecated

Riot Games API deprecated GET /lol/summoner/v4/summoners/by-name/{id} without giving a shutdown date yet.

Riot Games API deprecated the GET /lol/summoner/v4/summoners/by-name/{id} endpoint on October 16, 2023, without a shutdown date. Riot Games API discourages using these calls since they will be removed in the future, after which they fail.

## What to use instead

Resolve the Riot ID with GET /riot/account/v1/accounts/by-riot-id/{gameName}/{tagLine} on a regional host, then call GET /lol/summoner/v4/summoners/by-puuid/{encryptedPUUID}.

- API: Riot Games API (*.api.riotgames.com)
- Kind: Endpoint removal
- Announced: October 16, 2023
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `GET /lol/summoner/v4/summoners/by-name/{id}`
- Source: [Announcement](https://www.riotgames.com/en/DevRel/summoner-names-to-riot-id)
- Verified: November 6, 2026, against Riot Games API's own pages
- Page: https://www.okapi.bot/providers/riot-games-api/breaking-changes/get-lol-summoner-v4-summoners-by-name-is-deprecated/

## Riot Games API's words

> Although deprecated, they can still be used to convert Summoner Names to PUUID or summonerID. However, we discourage using them as part of your application since they will be removed in the future.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent