GET_getByPuuid
await client.GET_getByPuuid(puuid: str, cluster: Optional[str] = None)
Parameters
The PUUID of the account to retrieve.
The cluster to retrieve from. If not provided, uses the client’s default cluster.Valid clusters:
americasasiaesportseurope
Returns
Account information object (or raw dict if raw_data=True).
The player’s unique identifier.
The player’s in-game name (without tag).
The player’s tagline (e.g., “NA1”).
Exceptions
InvalidCluster - If the provided cluster is invalidRiotAPIResponseError - If the API response indicates an error (e.g., account not found)
Example
import asyncio
from valaw import Client
async def main():
client = Client(
token="RGAPI-your-api-key-here",
cluster="americas"
)
try:
# Get account by PUUID
account = await client.GET_getByPuuid(
puuid="abc123-def456-ghi789-jkl012"
)
print(f"PUUID: {account.puuid}")
print(f"Game Name: {account.gameName}")
print(f"Tag Line: {account.tagLine}")
print(f"Full ID: {account.gameName}#{account.tagLine}")
except Exception as e:
print(f"Error: {e}")
finally:
await client.close()
asyncio.run(main())
Example with Different Cluster
import asyncio
from valaw import Client
async def main():
client = Client(
token="RGAPI-your-api-key-here",
cluster="americas" # Default cluster
)
try:
# Query from a different cluster
account = await client.GET_getByPuuid(
puuid="abc123-def456-ghi789-jkl012",
cluster="europe" # Override default cluster
)
print(f"Found EU account: {account.gameName}#{account.tagLine}")
finally:
await client.close()
asyncio.run(main())
Response Example
AccountDto(
puuid="abc123-def456-ghi789-jkl012",
gameName="PlayerName",
tagLine="NA1"
)
The PUUID is a persistent identifier that remains constant even if a player changes their Riot ID (gameName#tagLine).
