Overview

Introduction

A typed, cached Python wrapper for Valorant content data.

valorant-assets-api wraps the public Valorant content API in one Python client that returns typed objects instead of raw dictionaries. The package is built for applications, scripts, and notebooks that need stable game metadata without repeating HTTP plumbing, response mapping, and local caching.

The wrapper tracks the same major data classes that the upstream Valorant API exposes, but the experience is SDK-shaped rather than endpoint-shaped. Each resource page in this site shows the client methods you call, the models you receive, and the wrapper behaviors layered on top of the raw API.

→ Quickstart

Construct a client, make a few real calls, and inspect typed fields.

→ Resource reference

Jump straight to the resource-oriented reference section.

What the wrapper gives you

One ValorantAPI client for the main public /v1 content endpoints.
Typed @apimodel resources and nested helper models.
Built-in caching through pypercache.
Wrapper helpers for common lookup flows like display-name search, active events, current season lookup, and flattened contract rewards.
Media URL fields wrapped as CachedMediaAsset for optional disk downloads.

What these docs optimize for

These docs follow the upstream resource-per-page scanning model, but each page is adapted to the Python API surface. You can open a resource page like Weapons to see the relevant client methods and the schema you get back in the same place.

Overview

Installation

Install the package and understand the runtime baseline.

Install the published package when you want the wrapper in an application environment:

pip install valorant-assets-api

Install the project in editable mode for local development and testing:

pip install -e .[test]

Requirements

Python >=3.11
requests>=2.31.0
pypercache>=0.1.9

What installation gives you

After installation, the package exports the main client, the shared enums, the root resource models, and CachedMediaAsset from the package root:

from valorant_assets_api import Language, ValorantAPI, Weapon

The package depends on the public Valorant content API. Calls that miss cache still require network access to https://valorant-api.com.

Overview

Quickstart

Construct a client and make a few real calls in under ten minutes.

Start with a default client and a few calls that exercise the main lookup styles:

from valorant_assets_api import ValorantAPI

api = ValorantAPI()

agents = api.list_agents(playable_only=True)
brimstone = api.find_agent("Brimstone", playable_only=True)
bind_map = api.find_map("Bind")
version = api.get_version()

print(agents[0].display_name)
print(brimstone.role.display_name if brimstone and brimstone.role else "No role")
print(bind_map.coordinates if bind_map else "No coordinates")
print(version.version)

What to notice

list_* methods return typed collections.
get_* methods fetch one typed object by UUID.
find_* helpers are convenience lookups for interactive or display-name-driven flows.
Returned objects expose nested models and enums directly.

The default client uses a temp-directory SQLite cache with a 24 hour expiry. Repeated calls are expected to hit cache for mostly static metadata.

Common lookup patterns
Client configuration
Weapons reference

Concepts

Caching and freshness

How the wrapper stores and reuses HTTP responses by default.

Caching is part of the package's normal usage model, not an optional afterthought. Most endpoints expose content metadata that changes slowly, so the default client stores responses locally and reuses them across calls.

Defaults

Setting	Default	Meaning
`cache_path`	temp SQLite path	Stores cached responses on disk
`default_expiry`	`60 * 60 * 24`	Freshness window for most endpoints
`timeout`	`20`	Request timeout in seconds
`request_log_path`	`None`	Logging disabled by default

Resource-specific freshness

Some endpoints override the default expiry in the client implementation:

Competitive tiers use a 12 hour expiry.
Missions and objectives use a 30 minute expiry.
Version metadata uses a 1 hour expiry.

Practical guidance

Keep the default cache for scripts and exploratory work.
Set cache_path explicitly when you want a reproducible project-local cache file.
Lower expiry values when you are validating freshness-sensitive behavior.
Enable request logging when you need to confirm which calls miss cache.

Cached media files are separate from the HTTP response cache. Resource metadata lives in the API cache, while downloaded images and audio files live under download_directory.

Concepts

Typed models and enums

How payloads become typed Python objects and enum-backed fields.

The wrapper hydrates API payloads into typed Python objects using @apimodel definitions from valorant_assets_api.models. That means resource pages can document the client call and the resulting schema together.

What typed hydration changes

You access fields as attributes instead of dictionary keys.
Nested objects such as Agent.role or Weapon.weapon_stats are hydrated into nested models.
Enum-backed fields are coerced into exported enums where possible.
Timestamp fields are converted to datetime objects.

Exported models vs nested helper models

The package root exports the main top-level resource models. Many resource pages also include nested helper models that are not exported from valorant_assets_api.__init__, but they still matter when you inspect real responses.

When a field type is written as Enum | str | None, the client tries to coerce known values into the enum while still tolerating unexpected upstream values.

Shared references

Enums for exported enum values
CachedMediaAsset for media URL behavior

Concepts

Media assets and disk downloads

How string-like media URLs become disk-fetchable assets.

Many response fields that look like plain media URLs are wrapped as CachedMediaAsset instances during model hydration. You can still treat them like strings, but the wrapper also lets you download and reuse them on disk.

How it works

A media field remains string-like, so str(asset) and normal URL usage still work.
The wrapper attaches API and resource context during hydration.
cache_to_disk() downloads or relocates the asset into download_directory.
fetch_from_disk() ensures the file exists locally and returns a Path.

Requirements

To fetch media files, construct the client with download_directory:

from valorant_assets_api import ValorantAPI

api = ValorantAPI(download_directory="cache/media")
agent = api.get_agent("add6443a-41bd-e414-f6ad-e58d267f4e95")
local_icon = agent.display_icon.fetch_from_disk()

Disk download methods raise ValueError when download_directory is not configured on the client.

See CachedMediaAsset for the helper reference and Agents or Weapons for real resource fields that use it.

Guides

Common lookup patterns

Consistent collection, UUID, and helper lookup flows across resources.

The client surface follows a consistent set of lookup patterns across resource types.

Collection lookups

Use list_* methods when you want a full collection of a resource type:

agents = api.list_agents(playable_only=True)
weapons = api.list_weapons()

UUID lookups

Use get_* methods when you already have a resource identifier:

agent = api.get_agent(agent_uuid)
weapon = api.get_weapon(weapon_uuid)

Display-name helpers

Some resources expose find_* helpers:

find_agent()
find_map()
find_weapon()

These helpers first try an exact case-insensitive display-name match, then a substring match.

Wrapper helpers

The client also exposes task-shaped helpers:

get_active_events() filters event windows against current or injected UTC time.
get_current_season() returns the current active season or None.
list_contract_rewards() flattens contract chapter rewards into one list.

Guides

Localization

Using the Language enum and language-aware resource methods.

Many content endpoints accept a language argument. The wrapper exposes the supported values through the Language enum while still accepting plain strings when that is more convenient.

from valorant_assets_api import Language, ValorantAPI

api = ValorantAPI()
weapons = api.list_weapons(language=Language.JA_JP)

Coverage

Localization support is resource-specific. The relevant resource pages document language only for methods that actually accept it in client.py.

Resources without language support in the current client implementation include:

Ceremonies
Competitive tiers
Missions
Objectives
Version

Use the enum when you want discoverable supported values. Use a string when the value comes from config or user input.

Guides

Client configuration

Constructor options and session-level customization points.

Construct ValorantAPI with defaults when you want the standard cached wrapper behavior, or override specific settings when your environment needs tighter control.

Parameter	Type	Default	Required	Description
`cache_path`	`str \| None`	temp SQLite path	no	Location for the HTTP response cache
`default_expiry`	`int \| float`	`86400`	no	Default freshness window in seconds
`request_log_path`	`str \| None`	`None`	no	Optional request log file path
`download_directory`	`str \| None`	`None`	no	Root directory for downloaded media assets
`timeout`	`int \| float \| None`	`20`	no	Request timeout in seconds
`session`	`requests.Session \| None`	`None`	no	Optional custom session

Session behavior

If you do not pass a session, the client creates one with:

Accept: application/json
User-Agent: valorant-api-wrapper/0.1.2

Use a custom session when you need shared headers, custom adapters, or request instrumentation beyond the built-in defaults.

Guides

Notebook walkthrough

When to use the repository notebook instead of the static docs.

The repository includes a guided notebook at notebooks/valorant_assets_api_tutorial.ipynb.

Use the notebook for an interactive walkthrough of:

package installation and setup
client construction
localization
UUID lookups
helper methods
cache configuration
typed model inspection

The embedded export below is a read-only preview of the executed notebook. Open the full export in a separate tab when you want native width, your browser's page search, or the original notebook source.

Notebook export

Executed HTML walkthrough

Open HTML export Open notebook source

This is a non-interactive export

Reference

Agents

Playable and non-playable agent data, plus role, ability, and voice metadata.

Agents maps to the upstream /agents resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/agents

Playable and non-playable agent data, plus role, ability, and voice metadata.

Client methods

`list_agents`

List agent resources.

list_agents(*, language: LanguageLike = None, playable_only: bool = False)

Returns: List[Agent]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.
`playable_only`	`bool`	`False`	no	When true, requests only playable agents from the collection endpoint.

Notes

Set playable_only=True to request only playable characters.

`get_agent`

Fetch one agent by UUID.

get_agent(agent_uuid: str, *, language: LanguageLike = None)

Returns: Agent

Parameters

Parameter	Type	Default	Required	Description
`agent_uuid`	`str`	`-`	yes	UUID of the target agent.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`find_agent`

Find an agent by display name.

find_agent(name: str, *, language: LanguageLike = None, playable_only: bool = False)

Returns: Agent | None

Parameters

Parameter	Type	Default	Required	Description
`name`	`str`	`-`	yes	Display name string used for wrapper-side matching.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.
`playable_only`	`bool`	`False`	no	When true, requests only playable agents from the collection endpoint.

Notes

The helper matches exact case-insensitive names before substring matches.

Schema

`Agent`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`description`	`str \| None`	-
`developer_name`	`str \| None`	`developerName`
`release_date`	`datetime \| None`	`releaseDate`
`character_tags`	`list[str] \| None`	`characterTags`
`display_icon`	`AssetUrl`	`displayIcon`
`display_icon_small`	`AssetUrl`	`displayIconSmall`
`bust_portrait`	`AssetUrl`	`bustPortrait`
`full_portrait`	`AssetUrl`	`fullPortrait`
`full_portrait_v2`	`AssetUrl`	`fullPortraitV2`
`killfeed_portrait`	`AssetUrl`	`killfeedPortrait`
`minimap_portrait`	`AssetUrl`	`minimapPortrait`
`home_screen_promo_tile_image`	`AssetUrl`	`homeScreenPromoTileImage`
`background`	`AssetUrl`	-
`background_gradient_colors`	`list[str]`	`backgroundGradientColors`
`asset_path`	`str \| None`	`assetPath`
`is_full_portrait_right_facing`	`bool`	`isFullPortraitRightFacing`
`is_playable_character`	`bool`	`isPlayableCharacter`
`is_available_for_test`	`bool`	`isAvailableForTest`
`is_base_content`	`bool`	`isBaseContent`
`role`	`Role \| None`	-
`recruitment_data`	`RecruitmentData \| None`	`recruitmentData`
`abilities`	`list[Ability]`	-
`voice_line`	`VoiceLine \| None`	`voiceLine`

`Role`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`description`	`str \| None`	-
`display_icon`	`AssetUrl`	`displayIcon`
`asset_path`	`str \| None`	`assetPath`

`Ability`

Field	Type	API alias
`slot`	`str`	-
`display_name`	`str \| None`	`displayName`
`description`	`str \| None`	-
`display_icon`	`AssetUrl`	`displayIcon`

`VoiceLine`

Field	Type	API alias
`min_duration`	`Numeric`	`minDuration`
`max_duration`	`Numeric`	`maxDuration`
`media_list`	`list[MediaAsset]`	`mediaList`

`RecruitmentData`

Field	Type	API alias
`counter_id`	`str \| None`	`counterId`
`milestone_id`	`str \| None`	`milestoneId`
`milestone_threshold`	`int \| None`	`milestoneThreshold`
`use_level_vp_cost_override`	`bool \| None`	`useLevelVpCostOverride`
`level_vp_cost_override`	`int \| None`	`levelVpCostOverride`
`start_date`	`datetime \| None`	`startDate`
`end_date`	`datetime \| None`	`endDate`

`MediaAsset`

Field	Type	API alias
`id`	`int \| None`	-
`wwise`	`AssetUrl`	-
`wave`	`AssetUrl`	-

Notes

Agent media fields such as display_icon and full_portrait are wrapped as CachedMediaAsset values.
Playable filtering is a wrapper-level convenience on top of the collection endpoint.

Reference

Buddies

Gun buddy collection and buddy level metadata.

Buddies maps to the upstream /buddies resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/buddies

Gun buddy collection and buddy level metadata.

Client methods

`list_buddies`

List buddy resources.

list_buddies(*, language: LanguageLike = None)

Returns: List[Buddy]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_buddy`

Fetch one buddy by UUID.

get_buddy(buddy_uuid: str, *, language: LanguageLike = None)

Returns: Buddy

Parameters

Parameter	Type	Default	Required	Description
`buddy_uuid`	`str`	`-`	yes	UUID of the target buddy.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

Schema

`Buddy`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`is_hidden_if_not_owned`	`bool \| None`	`isHiddenIfNotOwned`
`theme_uuid`	`str \| None`	`themeUuid`
`display_icon`	`AssetUrl`	`displayIcon`
`asset_path`	`str \| None`	`assetPath`
`levels`	`Lazy[list[BuddyLevel]]`	-

`BuddyLevel`

Field	Type	API alias
`uuid`	`str`	-
`charm_level`	`int \| None`	`charmLevel`
`hide_if_not_owned`	`bool \| None`	`hideIfNotOwned`
`display_name`	`str`	`displayName`
`display_icon`	`AssetUrl`	`displayIcon`
`asset_path`	`str \| None`	`assetPath`

Notes

levels is represented as a nested lazy list on the hydrated buddy model.

Reference

Bundles

Store bundle metadata and associated imagery.

Bundles maps to the upstream /bundles resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/bundles

Store bundle metadata and associated imagery.

Client methods

`list_bundles`

List bundle resources.

list_bundles(*, language: LanguageLike = None)

Returns: List[Bundle]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_bundle`

Fetch one bundle by UUID.

get_bundle(bundle_uuid: str, *, language: LanguageLike = None)

Returns: Bundle

Parameters

Parameter	Type	Default	Required	Description
`bundle_uuid`	`str`	`-`	yes	UUID of the target bundle.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

Schema

`Bundle`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`display_name_sub_text`	`str \| None`	`displayNameSubText`
`description`	`str \| None`	-
`extra_description`	`str \| None`	`extraDescription`
`promo_description`	`str \| None`	`promoDescription`
`display_icon`	`AssetUrl`	`displayIcon`
`display_icon_2`	`AssetUrl`	`displayIcon2`
`display_icon_3`	`AssetUrl`	`displayIcon3`
`vertical_promo_image`	`AssetUrl`	`verticalPromoImage`
`use_additional_context`	`bool \| None`	`useAdditionalContext`
`logo_icon`	`AssetUrl`	`logoIcon`
`asset_path`	`str \| None`	`assetPath`

Notes

Bundle image fields are wrapped as CachedMediaAsset values when present.

Reference

Ceremonies

Ceremony metadata with lightweight schema coverage.

Ceremonies maps to the upstream /ceremonies resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/ceremonies

Ceremony metadata with lightweight schema coverage.

Client methods

`list_ceremonies`

List ceremony resources.

list_ceremonies()

Returns: List[Ceremony]

Parameters

This method does not take caller-supplied parameters.

`get_ceremony`

Fetch one ceremony by UUID.

get_ceremony(ceremony_uuid: str)

Returns: Ceremony

Parameters

Parameter	Type	Default	Required	Description
`ceremony_uuid`	`str`	`-`	yes	UUID of the target ceremony.

Schema

`Ceremony`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`asset_path`	`str \| None`	`assetPath`

Notes

This resource does not expose language in the current client implementation.

Reference

Competitive Tiers

Competitive rank set data and nested tier definitions.

Competitive Tiers maps to the upstream /competitivetiers resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/competitivetiers

Competitive rank set data and nested tier definitions.

Client methods

`list_competitive_tiers`

List competitive tier sets.

list_competitive_tiers()

Returns: List[CompetitiveTierSet]

Parameters

This method does not take caller-supplied parameters.

Notes

The client applies a 12 hour expiry override.

`get_competitive_tier_set`

Fetch one competitive tier set by UUID.

get_competitive_tier_set(tier_set_uuid: str)

Returns: CompetitiveTierSet

Parameters

Parameter	Type	Default	Required	Description
`tier_set_uuid`	`str`	`-`	yes	UUID of the target competitive tier set.

Notes

The client applies a 12 hour expiry override.

Schema

`CompetitiveTierSet`

Field	Type	API alias
`uuid`	`str`	-
`asset_object_name`	`str \| None`	`assetObjectName`
`asset_path`	`str \| None`	`assetPath`
`tiers`	`Lazy[list[CompetitiveTier]]`	-

`CompetitiveTier`

Field	Type	API alias
`tier`	`int`	-
`tier_name`	`str`	`tierName`
`division`	`str`	-
`division_name`	`str`	`divisionName`
`color`	`str \| None`	-
`background_color`	`str \| None`	`backgroundColor`
`small_icon`	`AssetUrl`	`smallIcon`
`large_icon`	`AssetUrl`	`largeIcon`
`rank_triangle_down_icon`	`AssetUrl`	`rankTriangleDownIcon`
`rank_triangle_up_icon`	`AssetUrl`	`rankTriangleUpIcon`

Notes

This resource does not expose language in the current client implementation.

Reference

Content Tiers

Content tier metadata used across skins and rewards.

Content Tiers maps to the upstream /contenttiers resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/contenttiers

Content tier metadata used across skins and rewards.

Client methods

`list_content_tiers`

List content tier resources.

list_content_tiers(*, language: LanguageLike = None)

Returns: List[ContentTier]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_content_tier`

Fetch one content tier by UUID.

get_content_tier(content_tier_uuid: str, *, language: LanguageLike = None)

Returns: ContentTier

Parameters

Parameter	Type	Default	Required	Description
`content_tier_uuid`	`str`	`-`	yes	UUID of the target content tier.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

Schema

`ContentTier`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`dev_name`	`str \| None`	`devName`
`rank`	`int \| None`	-
`juice_value`	`int \| None`	`juiceValue`
`juice_cost`	`int \| None`	`juiceCost`
`highlight_color`	`str \| None`	`highlightColor`
`display_icon`	`AssetUrl`	`displayIcon`
`asset_path`	`str \| None`	`assetPath`

Notes

No extra wrapper notes for this resource.

Reference

Contracts

Contract data, reward schedules, and flattened reward helper output.

Contracts maps to the upstream /contracts resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/contracts

Contract data, reward schedules, and flattened reward helper output.

Client methods

`list_contracts`

List contract resources.

list_contracts(*, language: LanguageLike = None)

Returns: List[Contract]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_contract`

Fetch one contract by UUID.

get_contract(contract_uuid: str, *, language: LanguageLike = None)

Returns: Contract

Parameters

Parameter	Type	Default	Required	Description
`contract_uuid`	`str`	`-`	yes	UUID of the target contract.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`list_contract_rewards`

Flatten all chapter levels from one contract.

list_contract_rewards(contract_uuid: str, *, language: LanguageLike = None)

Returns: List[ContractLevel]

Parameters

Parameter	Type	Default	Required	Description
`contract_uuid`	`str`	`-`	yes	UUID of the target contract.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

Notes

This helper returns ContractLevel items rather than a top-level exported model.

Schema

`Contract`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`display_icon`	`AssetUrl`	`displayIcon`
`ship_it`	`bool \| None`	`shipIt`
`use_level_vp_cost_override`	`bool \| None`	`useLevelVPCostOverride`
`level_vp_cost_override`	`int \| None`	`levelVPCostOverride`
`free_reward_schedule_uuid`	`str \| None`	`freeRewardScheduleUuid`
`content`	`Lazy[ContractContent]`	-
`asset_path`	`str \| None`	`assetPath`

`ContractContent`

Field	Type	API alias
`relation_type`	`str \| None`	`relationType`
`relation_uuid`	`str \| None`	`relationUuid`
`chapters`	`Lazy[list[ContractChapter]]`	-
`premium_reward_schedule_uuid`	`str \| None`	`premiumRewardScheduleUuid`
`premium_vp_cost`	`int \| None`	`premiumVPCost`

`ContractChapter`

Field	Type	API alias
`is_epilogue`	`bool`	`isEpilogue`
`levels`	`list[ContractLevel]`	-
`free_rewards`	`list[Reward] \| None`	`freeRewards`

`ContractLevel`

Field	Type	API alias
`reward`	`Reward \| None`	-
`xp`	`int`	-
`vp_cost`	`int \| None`	`vpCost`
`is_purchasable_with_vp`	`bool \| None`	`isPurchasableWithVP`
`dough_cost`	`int \| None`	`doughCost`
`is_purchasable_with_dough`	`bool \| None`	`isPurchasableWithDough`

`Reward`

Field	Type	API alias
`type`	`str`	-
`uuid`	`str`	-
`amount`	`int`	-
`is_highlighted`	`bool`	`isHighlighted`

Notes

list_contract_rewards() is wrapper-specific and does not map to a direct endpoint.

Reference

Currencies

Currency metadata and reward icon fields.

Currencies maps to the upstream /currencies resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/currencies

Currency metadata and reward icon fields.

Client methods

`list_currencies`

List currency resources.

list_currencies(*, language: LanguageLike = None)

Returns: List[Currency]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_currency`

Fetch one currency by UUID.

get_currency(currency_uuid: str, *, language: LanguageLike = None)

Returns: Currency

Parameters

Parameter	Type	Default	Required	Description
`currency_uuid`	`str`	`-`	yes	UUID of the target currency.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

Schema

`Currency`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`display_name_singular`	`str \| None`	`displayNameSingular`
`display_icon`	`AssetUrl`	`displayIcon`
`large_icon`	`AssetUrl`	`largeIcon`
`reward_preview_icon`	`AssetUrl`	`rewardPreviewIcon`
`asset_path`	`str \| None`	`assetPath`

Notes

No extra wrapper notes for this resource.

Reference

Events

Event metadata plus wrapper-level active window filtering.

Events maps to the upstream /events resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/events

Event metadata plus wrapper-level active window filtering.

Client methods

`list_events`

List event resources.

list_events(*, language: LanguageLike = None)

Returns: List[Event]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_event`

Fetch one event by UUID.

get_event(event_uuid: str, *, language: LanguageLike = None)

Returns: Event

Parameters

Parameter	Type	Default	Required	Description
`event_uuid`	`str`	`-`	yes	UUID of the target event.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_active_events`

Return currently active events.

get_active_events(*, language: LanguageLike = None, now: datetime | None = None)

Returns: List[Event]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.
`now`	`datetime \| None`	`None`	no	Optional UTC timestamp used instead of the current time.

Notes

The helper compares event windows against now or the current UTC time.

Schema

`Event`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str \| None`	`displayName`
`short_display_name`	`str \| None`	`shortDisplayName`
`start_time`	`datetime \| None`	`startTime`
`end_time`	`datetime \| None`	`endTime`
`asset_path`	`str \| None`	`assetPath`

Notes

get_active_events() is a wrapper helper layered on top of list_events().

Reference

Gamemodes

Gamemode metadata and nested game rule overrides.

Gamemodes maps to the upstream /gamemodes resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/gamemodes

Gamemode metadata and nested game rule overrides.

Client methods

`list_gamemodes`

List gamemode resources.

list_gamemodes(*, language: LanguageLike = None)

Returns: List[Gamemode]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_gamemode`

Fetch one gamemode by UUID.

get_gamemode(gamemode_uuid: str, *, language: LanguageLike = None)

Returns: Gamemode

Parameters

Parameter	Type	Default	Required	Description
`gamemode_uuid`	`str`	`-`	yes	UUID of the target gamemode.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

Schema

`Gamemode`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`description`	`str \| None`	-
`duration`	`str \| None`	-
`display_icon`	`AssetUrl`	`displayIcon`
`asset_path`	`str \| None`	`assetPath`
`team_roles`	`list[str] \| None`	`teamRoles`
`game_feature_overrides`	`list[GameFeatureOverride] \| None`	`gameFeatureOverrides`
`game_rule_bool_overrides`	`list[GameRuleBoolOverride] \| None`	`gameRuleBoolOverrides`
`allows_match_timeouts`	`bool \| None`	`allowsMatchTimeouts`
`allows_custom_game_replays`	`bool \| None`	`allowsCustomGameReplays`
`is_minimap_hidden`	`bool \| None`	`isMinimapHidden`
`is_team_voice_allowed`	`bool \| None`	`isTeamVoiceAllowed`
`orb_count`	`int \| None`	`orbCount`
`rounds_per_half`	`int \| None`	`roundsPerHalf`
`economy_type`	`str \| None`	`economyType`
`list_view_icon_tall`	`AssetUrl`	`listViewIconTall`

`GameFeatureOverride`

Field	Type	API alias
`feature_name`	`str`	`featureName`
`state`	`bool`	-

`GameRuleBoolOverride`

Field	Type	API alias
`rule_name`	`str`	`ruleName`
`state`	`bool`	-

Notes

No extra wrapper notes for this resource.

Reference

Gear

Gear metadata, nested shop data, and descriptive detail rows.

Gear maps to the upstream /gear resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/gear

Gear metadata, nested shop data, and descriptive detail rows.

Client methods

`list_gear`

List gear resources.

list_gear(*, language: LanguageLike = None)

Returns: List[Gear]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_gear`

Fetch one gear item by UUID.

get_gear(gear_uuid: str, *, language: LanguageLike = None)

Returns: Gear

Parameters

Parameter	Type	Default	Required	Description
`gear_uuid`	`str`	`-`	yes	UUID of the target gear item.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

Schema

`Gear`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`description`	`str \| None`	-
`descriptions`	`list[str] \| None`	-
`details`	`list[GearDetail] \| None`	-
`display_icon`	`AssetUrl`	`displayIcon`
`asset_path`	`str \| None`	`assetPath`
`shop_data`	`ShopData \| None`	`shopData`

`GearDetail`

Field	Type	API alias
`name`	`str`	-
`value`	`str \| None`	-

`ShopData`

Field	Type	API alias
`cost`	`int \| None`	-
`category`	`str \| None`	-
`shop_order_priority`	`int \| None`	`shopOrderPriority`
`category_text`	`str \| None`	`categoryText`
`grid_position`	`ShopGridPosition \| None`	`gridPosition`
`can_be_trashed`	`bool \| None`	`canBeTrashed`
`image`	`AssetUrl`	-
`new_image`	`AssetUrl`	`newImage`
`new_image_2`	`AssetUrl`	`newImage2`
`asset_path`	`str \| None`	`assetPath`

`ShopGridPosition`

Field	Type	API alias
`row`	`int \| None`	-
`column`	`int \| None`	-

Notes

No extra wrapper notes for this resource.

Reference

Level Borders

Level border metadata and progression display fields.

Level Borders maps to the upstream /levelborders resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/levelborders

Level border metadata and progression display fields.

Client methods

`list_level_borders`

List level border resources.

list_level_borders(*, language: LanguageLike = None)

Returns: List[LevelBorder]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_level_border`

Fetch one level border by UUID.

get_level_border(level_border_uuid: str, *, language: LanguageLike = None)

Returns: LevelBorder

Parameters

Parameter	Type	Default	Required	Description
`level_border_uuid`	`str`	`-`	yes	UUID of the target level border.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

Schema

`LevelBorder`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`starting_level`	`int`	`startingLevel`
`level_number`	`int`	`levelNumber`
`level_number_appearance`	`str \| None`	`levelNumberAppearance`
`small_player_card_appearance`	`str \| None`	`smallPlayerCardAppearance`
`asset_path`	`str \| None`	`assetPath`

Notes

No extra wrapper notes for this resource.

Reference

Maps

Map metadata, coordinate helpers, and nested callout positions.

Maps maps to the upstream /maps resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/maps

Map metadata, coordinate helpers, and nested callout positions.

Client methods

`list_maps`

List map resources.

list_maps(*, language: LanguageLike = None)

Returns: List[MapInfo]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_map`

Fetch one map by UUID.

get_map(map_uuid: str, *, language: LanguageLike = None)

Returns: MapInfo

Parameters

Parameter	Type	Default	Required	Description
`map_uuid`	`str`	`-`	yes	UUID of the target map.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`find_map`

Find a map by display name.

find_map(name: str, *, language: LanguageLike = None)

Returns: MapInfo | None

Parameters

Parameter	Type	Default	Required	Description
`name`	`str`	`-`	yes	Display name string used for wrapper-side matching.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

Notes

The helper matches exact case-insensitive names before substring matches.

Schema

`MapInfo`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`narrative_description`	`str \| None`	`narrativeDescription`
`tactical_description`	`str \| None`	`tacticalDescription`
`coordinates`	`str \| None`	-
`display_icon`	`AssetUrl`	`displayIcon`
`list_view_icon`	`AssetUrl`	`listViewIcon`
`list_view_icon_tall`	`AssetUrl`	`listViewIconTall`
`splash`	`AssetUrl`	-
`stylized_background_image`	`AssetUrl`	`stylizedBackgroundImage`
`premier_background_image`	`AssetUrl`	`premierBackgroundImage`
`asset_path`	`str \| None`	`assetPath`
`map_url`	`str \| None`	`mapUrl`
`x_multiplier`	`Numeric`	`xMultiplier`
`y_multiplier`	`Numeric`	`yMultiplier`
`x_scalar_to_add`	`Numeric`	`xScalarToAdd`
`y_scalar_to_add`	`Numeric`	`yScalarToAdd`
`callouts`	`Lazy[list[Callout] \| None] \| None`	-

`Callout`

Field	Type	API alias
`region_name`	`str`	`regionName`
`super_region`	`str \| None`	`superRegion`
`super_region_name`	`str \| None`	`superRegionName`
`location`	`Position3D`	-
`scale_3d`	`Position3D \| None`	`scale3D`
`rotation`	`Rotation3D \| None`	-

`Position3D`

Field	Type	API alias
`x`	`float \| int`	-
`y`	`float \| int`	-
`z`	`float \| int`	-

`Rotation3D`

Field	Type	API alias
`pitch`	`float \| int`	-
`yaw`	`float \| int`	-
`roll`	`float \| int`	-

Notes

Map image fields are wrapped as CachedMediaAsset values when present.

Reference

Missions

Mission metadata and nested objective progress rows.

Missions maps to the upstream /missions resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/missions

Mission metadata and nested objective progress rows.

Client methods

`list_missions`

List mission resources.

list_missions()

Returns: List[Mission]

Parameters

This method does not take caller-supplied parameters.

Notes

The client applies a 30 minute expiry override.

`get_mission`

Fetch one mission by UUID.

get_mission(mission_uuid: str)

Returns: Mission

Parameters

Parameter	Type	Default	Required	Description
`mission_uuid`	`str`	`-`	yes	UUID of the target mission.

Notes

The client applies a 30 minute expiry override.

Schema

`Mission`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str \| None`	`displayName`
`title`	`str \| None`	-
`type`	`MissionType \| str \| None`	-
`xp_grant`	`int \| None`	`xpGrant`
`progress_to_complete`	`int \| None`	`progressToComplete`
`activation_date`	`datetime \| None`	`activationDate`
`expiration_date`	`datetime \| None`	`expirationDate`
`tags`	`list[str] \| None`	-
`objectives`	`list[MissionObjectiveProgress] \| None`	-
`asset_path`	`str \| None`	`assetPath`

`MissionObjectiveProgress`

Field	Type	API alias
`objective_uuid`	`str`	`objectiveUuid`
`value`	`int`	-

Notes

This resource does not expose language in the current client implementation.

Reference

Objectives

Objective metadata used by mission payloads.

Objectives maps to the upstream /objectives resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/objectives

Objective metadata used by mission payloads.

Client methods

`list_objectives`

List objective resources.

list_objectives()

Returns: List[Objective]

Parameters

This method does not take caller-supplied parameters.

Notes

The client applies a 30 minute expiry override.

`get_objective`

Fetch one objective by UUID.

get_objective(objective_uuid: str)

Returns: Objective

Parameters

Parameter	Type	Default	Required	Description
`objective_uuid`	`str`	`-`	yes	UUID of the target objective.

Notes

The client applies a 30 minute expiry override.

Schema

`Objective`

Field	Type	API alias
`uuid`	`str`	-
`directive`	`str \| None`	-
`asset_path`	`str \| None`	`assetPath`

Notes

This resource does not expose language in the current client implementation.

Reference

Player Cards

Player card metadata and the associated art variants.

Player Cards maps to the upstream /playercards resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/playercards

Player card metadata and the associated art variants.

Client methods

`list_player_cards`

List player card resources.

list_player_cards(*, language: LanguageLike = None)

Returns: List[PlayerCard]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_player_card`

Fetch one player card by UUID.

get_player_card(card_uuid: str, *, language: LanguageLike = None)

Returns: PlayerCard

Parameters

Parameter	Type	Default	Required	Description
`card_uuid`	`str`	`-`	yes	UUID of the target player card.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

Schema

`PlayerCard`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`is_hidden_if_not_owned`	`bool \| None`	`isHiddenIfNotOwned`
`theme_uuid`	`str \| None`	`themeUuid`
`display_icon`	`AssetUrl`	`displayIcon`
`small_art`	`AssetUrl`	`smallArt`
`wide_art`	`AssetUrl`	`wideArt`
`large_art`	`AssetUrl`	`largeArt`
`asset_path`	`str \| None`	`assetPath`

Notes

Art fields such as small_art, wide_art, and large_art are wrapped as CachedMediaAsset values.

Reference

Player Titles

Player title metadata and title text fields.

Player Titles maps to the upstream /playertitles resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/playertitles

Player title metadata and title text fields.

Client methods

`list_player_titles`

List player title resources.

list_player_titles(*, language: LanguageLike = None)

Returns: List[PlayerTitle]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_player_title`

Fetch one player title by UUID.

get_player_title(title_uuid: str, *, language: LanguageLike = None)

Returns: PlayerTitle

Parameters

Parameter	Type	Default	Required	Description
`title_uuid`	`str`	`-`	yes	UUID of the target player title.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

Schema

`PlayerTitle`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str \| None`	`displayName`
`title_text`	`str \| None`	`titleText`
`is_hidden_if_not_owned`	`bool \| None`	`isHiddenIfNotOwned`
`asset_path`	`str \| None`	`assetPath`

Notes

No extra wrapper notes for this resource.

Reference

Seasons

Season metadata plus the helper for selecting the active season.

Seasons maps to the upstream /seasons resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/seasons

Season metadata plus the helper for selecting the active season.

Client methods

`list_seasons`

List season resources.

list_seasons(*, language: LanguageLike = None)

Returns: List[Season]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_season`

Fetch one season by UUID.

get_season(season_uuid: str, *, language: LanguageLike = None)

Returns: Season

Parameters

Parameter	Type	Default	Required	Description
`season_uuid`	`str`	`-`	yes	UUID of the target season.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_current_season`

Return the active season.

get_current_season(*, language: LanguageLike = None, now: datetime | None = None)

Returns: Season | None

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.
`now`	`datetime \| None`	`None`	no	Optional UTC timestamp used instead of the current time.

Notes

The helper compares season windows against now or the current UTC time and returns None when nothing is active.

Schema

`Season`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`title`	`str \| None`	-
`type`	`str \| None`	-
`parent_uuid`	`str \| None`	`parentUuid`
`start_time`	`datetime \| None`	`startTime`
`end_time`	`datetime \| None`	`endTime`
`asset_path`	`str \| None`	`assetPath`

Notes

get_current_season() is a wrapper helper layered on top of list_seasons().

Reference

Sprays

Spray metadata, art assets, and nested spray levels.

Sprays maps to the upstream /sprays resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/sprays

Spray metadata, art assets, and nested spray levels.

Client methods

`list_sprays`

List spray resources.

list_sprays(*, language: LanguageLike = None)

Returns: List[Spray]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_spray`

Fetch one spray by UUID.

get_spray(spray_uuid: str, *, language: LanguageLike = None)

Returns: Spray

Parameters

Parameter	Type	Default	Required	Description
`spray_uuid`	`str`	`-`	yes	UUID of the target spray.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

Schema

`Spray`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`category`	`str \| None`	-
`theme_uuid`	`str \| None`	`themeUuid`
`display_icon`	`AssetUrl`	`displayIcon`
`full_icon`	`AssetUrl`	`fullIcon`
`full_transparent_icon`	`AssetUrl`	`fullTransparentIcon`
`animation_gif`	`AssetUrl`	`animationGif`
`animation_png`	`AssetUrl`	`animationPng`
`hide_if_not_owned`	`bool \| None`	`hideIfNotOwned`
`is_null_spray`	`bool \| None`	`isNullSpray`
`asset_path`	`str \| None`	`assetPath`
`levels`	`Lazy[list[SprayLevel]]`	-

`SprayLevel`

Field	Type	API alias
`uuid`	`str`	-
`spray_level`	`int \| None`	`sprayLevel`
`display_name`	`str`	`displayName`
`display_icon`	`AssetUrl`	`displayIcon`
`asset_path`	`str \| None`	`assetPath`

Notes

Animation and icon fields are wrapped as CachedMediaAsset values when present.

Reference

Themes

Theme metadata and store artwork fields.

Themes maps to the upstream /themes resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/themes

Theme metadata and store artwork fields.

Client methods

`list_themes`

List theme resources.

list_themes(*, language: LanguageLike = None)

Returns: List[Theme]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_theme`

Fetch one theme by UUID.

get_theme(theme_uuid: str, *, language: LanguageLike = None)

Returns: Theme

Parameters

Parameter	Type	Default	Required	Description
`theme_uuid`	`str`	`-`	yes	UUID of the target theme.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

Schema

`Theme`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`display_icon`	`AssetUrl`	`displayIcon`
`store_featured_image`	`AssetUrl`	`storeFeaturedImage`
`asset_path`	`str \| None`	`assetPath`

Notes

No extra wrapper notes for this resource.

Reference

Weapons

Weapon metadata, nested stats, shop data, skins, chromas, and damage ranges.

Weapons maps to the upstream /weapons resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/weapons

Weapon metadata, nested stats, shop data, skins, chromas, and damage ranges.

Client methods

`list_weapons`

List weapon resources.

list_weapons(*, language: LanguageLike = None)

Returns: List[Weapon]

Parameters

Parameter	Type	Default	Required	Description
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`get_weapon`

Fetch one weapon by UUID.

get_weapon(weapon_uuid: str, *, language: LanguageLike = None)

Returns: Weapon

Parameters

Parameter	Type	Default	Required	Description
`weapon_uuid`	`str`	`-`	yes	UUID of the target weapon.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

`find_weapon`

Find a weapon by display name.

find_weapon(name: str, *, language: LanguageLike = None)

Returns: Weapon | None

Parameters

Parameter	Type	Default	Required	Description
`name`	`str`	`-`	yes	Display name string used for wrapper-side matching.
`language`	`LanguageLike`	`None`	no	Localization code for endpoints that expose translated content.

Notes

The helper matches exact case-insensitive names before substring matches.

Schema

`Weapon`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`category`	`WeaponCategory \| str \| None`	-
`default_skin_uuid`	`str \| None`	`defaultSkinUuid`
`display_icon`	`AssetUrl`	`displayIcon`
`kill_stream_icon`	`AssetUrl`	`killStreamIcon`
`asset_path`	`str \| None`	`assetPath`
`weapon_stats`	`WeaponStats \| None`	`weaponStats`
`shop_data`	`ShopData \| None`	`shopData`
`skins`	`Lazy[list[WeaponSkin]]`	-

`WeaponStats`

Field	Type	API alias
`fire_rate`	`float \| int \| None`	`fireRate`
`magazine_size`	`int \| None`	`magazineSize`
`run_speed_multiplier`	`float \| int \| None`	`runSpeedMultiplier`
`equip_time_seconds`	`float \| int \| None`	`equipTimeSeconds`
`reload_time_seconds`	`float \| int \| None`	`reloadTimeSeconds`
`first_bullet_accuracy`	`float \| int \| None`	`firstBulletAccuracy`
`shotgun_pellet_count`	`int \| None`	`shotgunPelletCount`
`wall_penetration`	`WallPenetration \| str \| None`	`wallPenetration`
`feature`	`WeaponStatsFeature \| str \| None`	-
`fire_mode`	`str \| None`	`fireMode`
`alt_fire_type`	`AltFireType \| str \| None`	`altFireType`
`ads_stats`	`AdsStats \| None`	`adsStats`
`alt_shotgun_stats`	`AltShotgunStats \| None`	`altShotgunStats`
`air_burst_stats`	`AirBurstStats \| None`	`airBurstStats`
`damage_ranges`	`list[DamageRange] \| None`	`damageRanges`

`WeaponSkin`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`theme_uuid`	`str \| None`	`themeUuid`
`content_tier_uuid`	`str \| None`	`contentTierUuid`
`display_icon`	`AssetUrl`	`displayIcon`
`wallpaper`	`AssetUrl`	-
`asset_path`	`str \| None`	`assetPath`
`chromas`	`list[WeaponChroma]`	-
`levels`	`list[WeaponSkinLevel]`	-

`WeaponSkinLevel`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`level_item`	`str \| None`	`levelItem`
`display_icon`	`AssetUrl`	`displayIcon`
`streamed_video`	`AssetUrl`	`streamedVideo`
`asset_path`	`str \| None`	`assetPath`

`WeaponChroma`

Field	Type	API alias
`uuid`	`str`	-
`display_name`	`str`	`displayName`
`display_icon`	`AssetUrl`	`displayIcon`
`full_render`	`AssetUrl`	`fullRender`
`swatch`	`AssetUrl`	-
`streamed_video`	`AssetUrl`	`streamedVideo`
`asset_path`	`str \| None`	`assetPath`

`DamageRange`

Field	Type	API alias
`range_start_meters`	`float \| int`	`rangeStartMeters`
`range_end_meters`	`float \| int`	`rangeEndMeters`
`head_damage`	`float \| int`	`headDamage`
`body_damage`	`float \| int`	`bodyDamage`
`leg_damage`	`float \| int`	`legDamage`

`AdsStats`

Field	Type	API alias
`zoom_multiplier`	`float \| int \| None`	`zoomMultiplier`
`fire_rate`	`float \| int \| None`	`fireRate`
`run_speed_multiplier`	`float \| int \| None`	`runSpeedMultiplier`
`burst_count`	`int \| None`	`burstCount`
`first_bullet_accuracy`	`float \| int \| None`	`firstBulletAccuracy`

`AltShotgunStats`

Field	Type	API alias
`shotgun_pellet_count`	`int \| None`	`shotgunPelletCount`
`burst_rate`	`float \| int \| None`	`burstRate`

`AirBurstStats`

Field	Type	API alias
`shotgun_pellet_count`	`int \| None`	`shotgunPelletCount`
`burst_distance`	`float \| int \| None`	`burstDistance`

`ShopData`

Field	Type	API alias
`cost`	`int \| None`	-
`category`	`str \| None`	-
`shop_order_priority`	`int \| None`	`shopOrderPriority`
`category_text`	`str \| None`	`categoryText`
`grid_position`	`ShopGridPosition \| None`	`gridPosition`
`can_be_trashed`	`bool \| None`	`canBeTrashed`
`image`	`AssetUrl`	-
`new_image`	`AssetUrl`	`newImage`
`new_image_2`	`AssetUrl`	`newImage2`
`asset_path`	`str \| None`	`assetPath`

`ShopGridPosition`

Field	Type	API alias
`row`	`int \| None`	-
`column`	`int \| None`	-

Notes

Weapon and skin image or video fields are wrapped as CachedMediaAsset values when present.

Reference

Version

Current Valorant client and manifest version metadata.

Version maps to the upstream /version resource family and groups the wrapper methods with the typed models you inspect after hydration.

Endpoint family

https://valorant-api.com/v1/version

Current Valorant client and manifest version metadata.

Client methods

`get_version`

Fetch the current version metadata.

get_version()

Returns: ValorantVersion

Parameters

This method does not take caller-supplied parameters.

Notes

The client applies a 1 hour expiry override.

Schema

`ValorantVersion`

Field	Type	API alias
`manifest_id`	`str \| None`	`manifestId`
`branch`	`str \| None`	-
`version`	`str \| None`	-
`build_version`	`str \| None`	`buildVersion`
`engine_version`	`str \| None`	`engineVersion`
`riot_client_version`	`str \| None`	`riotClientVersion`
`riot_client_build`	`str \| None`	`riotClientBuild`
`build_date`	`datetime \| None`	`buildDate`

Notes

This resource does not expose language in the current client implementation.

Appendix

Enums

Exported enum values used across the resource reference.

The wrapper exports a small set of enums that appear across multiple resource pages.

`Language`

EN_US = en-US
ES_ES = es-ES
FR_FR = fr-FR
DE_DE = de-DE
IT_IT = it-IT
JA_JP = ja-JP
KO_KR = ko-KR
PL_PL = pl-PL
PT_BR = pt-BR
RU_RU = ru-RU
TH_TH = th-TH
TR_TR = tr-TR
VI_VN = vi-VN
ZH_CN = zh-CN
ZH_TW = zh-TW
ID_ID = id-ID
AR_AE = ar-AE

`WeaponCategory`

SIDEARM = EEquippableCategory::Sidearm
SMG = EEquippableCategory::SMG
RIFLE = EEquippableCategory::Rifle
SNIPER = EEquippableCategory::Sniper
SHOTGUN = EEquippableCategory::Shotgun
HEAVY = EEquippableCategory::Heavy
MELEE = EEquippableCategory::Melee

`WallPenetration`

LOW = EWallPenetrationDisplayType::Low
MEDIUM = EWallPenetrationDisplayType::Medium
HIGH = EWallPenetrationDisplayType::High

`AltFireType`

ADS = EWeaponAltFireDisplayType::ADS
AIR_BURST = EWeaponAltFireDisplayType::AirBurst
SHOTGUN = EWeaponAltFireDisplayType::Shotgun

`WeaponStatsFeature`

ROF_INCREASE = EWeaponStatsFeature::ROFIncrease
DOUBLE_ZOOM = EWeaponStatsFeature::DoubleZoom
SILENCED = EWeaponStatsFeature::Silenced

`MissionType`

BTE = EAresMissionType::BTE
DAILY = EAresMissionType::Daily
WEEKLY = EAresMissionType::Weekly
NPE = EAresMissionType::NPE

Appendix

CachedMediaAsset

String-like media URL helper with optional disk fetching.

CachedMediaAsset is the wrapper's string-like media helper. Resource pages use it for fields such as Agent.display_icon, PlayerCard.large_art, or WeaponSkin.streamed_video.

Helper surface

CachedMediaAsset.url

Returns the original remote URL as a string.

CachedMediaAsset.filepath

Returns the cached local Path when the asset has already been downloaded or relocated, otherwise None.

CachedMediaAsset.cache_to_disk()

Downloads or relocates the asset into the client's download_directory and returns the same CachedMediaAsset.

CachedMediaAsset.fetch_from_disk()

Ensures the file exists locally and returns its Path.

Behavior notes

The helper subclasses str, so you can pass it where a URL string is expected.
The cache key for local media files is derived from the media URL.
Repeated downloads reuse cached files instead of re-fetching when possible.
Missing client attachment or missing download_directory raises ValueError.

See Media assets and disk downloads for the conceptual guide.