Skip to main content

ContentDto

Returned by GET_getContent.
FieldTypeDescription
versionstrContent version identifier
characterslist[ContentItemDto]VALORANT agents
mapslist[ContentItemDto]Maps
chromaslist[ContentItemDto]Weapon skin chromas
skinslist[ContentItemDto]Weapon skins
skinLevelslist[ContentItemDto]Skin levels
equipslist[ContentItemDto]Equippable items
gameModeslist[ContentItemDto]Game modes
totemslist[ContentItemDto]Totems
sprayslist[ContentItemDto]Sprays
sprayLevelslist[ContentItemDto]Spray levels
charmslist[ContentItemDto]Gun buddies
charmLevelslist[ContentItemDto]Charm levels
playerCardslist[ContentItemDto]Player cards
playerTitleslist[ContentItemDto]Player titles
actslist[ActDto]Acts and episodes
ceremonieslist[ContentItemDto]Ceremonies

ContentItemDto

A single content item (agent, map, skin, etc.).
FieldTypeDescription
namestrEnglish name of the item
idstrUnique identifier
assetNamestrInternal asset name
localizedNamesLocalizedNamesDto | NoneLocalized names in all supported languages
assetPathstr | NoneAsset path

ActDto

An act or episode in VALORANT.
FieldTypeDescription
namestrName of the act/episode
idstrUnique identifier (use as actId for leaderboard endpoints)
isActiveboolWhether this act is currently active
typestrType ("act" or "episode")
localizedNamesLocalizedNamesDto | NoneLocalized names
parentIdstr | NoneParent episode ID (for acts)

LocalizedNamesDto

Contains the item name in all supported locales. Field names use underscores instead of hyphens.
FieldLocale
ar_AEArabic (UAE)
de_DEGerman
en_GBEnglish (UK)
en_USEnglish (US)
es_ESSpanish (Spain)
es_MXSpanish (Mexico)
fr_FRFrench
id_IDIndonesian
it_ITItalian
ja_JPJapanese
ko_KRKorean
pl_PLPolish
pt_BRPortuguese (Brazil)
ru_RURussian
th_THThai
tr_TRTurkish
vi_VNVietnamese
zh_CNChinese (Simplified)
zh_TWChinese (Traditional)

Example

import valaw
import asyncio

async def main():
    client = valaw.Client("YOUR_TOKEN", "americas")
    try:
        content = await client.GET_getContent("na", "en-US")

        print(f"Version: {content.version}")

        # List agents
        for character in content.characters:
            print(f"  {character.name} ({character.id})")

        # Find the current active act (useful for leaderboard actId)
        for act in content.acts:
            if act.isActive and act.type == "act":
                print(f"Current act: {act.name} — ID: {act.id}")
    finally:
        await client.close()

asyncio.run(main())
Use the id from an active ActDto as the actId parameter for GET_getLeaderboard.