Gear & Armor API — GET /v1/gear endpoints

The Gear API returns data on all purchasable defensive items in Valorant, including Light Shields and Heavy Shields. Each gear item includes its description, display icon, cost, and shop metadata such as category and priority ordering. You can retrieve the full gear list or look up a specific item by UUID.

The User-Agent header is required for all requests. Use the format AppName/Version (+URL) — for example, MyApp/1.0 (+https://example.com).

Endpoints

Method	Path	Description
GET	`/v1/gear`	Returns all gear items
GET	`/v1/gear/{uuid}`	Returns a single gear item by UUID

GET /v1/gear

Returns an array of all purchasable gear items.

Request parameters

string

required

Identifies your application. Format: AppName/Version (+URL).

string

default:"en-US"

Locale for localized display names and descriptions. Example: pt-BR, zh-TW.

Example request

curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/gear" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/gear?language=pt-BR" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

Response

{
  "status": 200,
  "data": [
    {
      "uuid": "822bcab2-40a2-324e-c137-e09195ad7692",
      "displayName": "Armadura Pesada",
      "description": "Absorve 66% do dano total sofrido. Quebra após absorver 50 de dano.",
      "displayIcon": "https://valmedia.teamfortuna.xyz/gear/822bcab2-40a2-324e-c137-e09195ad7692/displayicon.png",
      "assetPath": "ShooterGame/Content/Gear/HeavyArmor_PrimaryAsset",
      "shopData": null
    }
  ]
}

GET /v1/gear/

Returns a single gear item matching the provided UUID.

Request parameters

string

required

The UUID of the gear item to retrieve.

string

required

Identifies your application. Format: AppName/Version (+URL).

string

default:"en-US"

Locale for localized display names and descriptions.

Example request

cURL

curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/gear/822bcab2-40a2-324e-c137-e09195ad7692" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

Response

{
  "status": 200,
  "data": {
    "uuid": "822bcab2-40a2-324e-c137-e09195ad7692",
    "displayName": "Heavy Armor",
    "description": "Absorbs 66% of total damage taken. Breaks after it has absorbed 50 damage.",
    "displayIcon": "https://valmedia.teamfortuna.xyz/gear/822bcab2-40a2-324e-c137-e09195ad7692/displayicon.png",
    "assetPath": "ShooterGame/Content/Gear/HeavyArmor_PrimaryAsset",
    "shopData": null
  }
}

Response fields

string

required

Unique identifier for the gear item.

string

required

Localized name of the gear item (e.g., "Heavy Shields", "Light Shields").

string

Localized description of the gear item’s function in gameplay.

string

URL to the gear item’s display icon.

string

Internal Unreal Engine asset path.

object

Metadata about how the item appears and behaves in the buy phase shop.

Show shopData properties

number

Purchase cost in Creds.

string

Internal shop category string (e.g., "Gear").

number

Sort priority within the shop UI.

string

Localized category label shown in the shop.

object

Grid slot position in the shop layout. null if not assigned.

boolean

Whether the item can be dropped or sold back during the buy phase.

string

Legacy shop image URL. May be null.

string

Primary shop image URL used in the current UI.

string

Secondary shop image URL. May be null.

string

Internal Unreal Engine asset path for the shop data object.

⌘I

System

Agents & Characters

Cosmetics

Weapons

Game Data

Premier

Localization

Gear & Armor API — GET /v1/gear endpoints

Endpoints

GET /v1/gear

Request parameters

Example request

Response

GET /v1/gear/

Request parameters

Example request

Response

Response fields

​Endpoints

​GET /v1/gear

​Request parameters

​Example request

​Response

​GET /v1/gear/

​Request parameters

​Example request

​Response

​Response fields

Endpoints

GET /v1/gear

Request parameters

Example request

Response

GET /v1/gear/

Request parameters

Example request

Response

Response fields