Agents & Roles API — GET /v1/agents endpoints

Valorant agents are the playable characters at the heart of every match. Each agent belongs to one of four roles — Duelist, Initiator, Controller, or Sentinel — and comes with a unique set of abilities. The Agents API gives you access to localized display names, rich visual assets (portraits, icons, background images), role metadata, and full ability descriptions for every agent in the game.

List all agents

Retrieve the full list of all Valorant agents.

Endpoint

GET https://astra.teamfortuna.xyz/v1/agents

Query parameters

string

default:"en-US"

Locale code for response text. Defaults to en-US. Supported values: ar-AE, de-DE, en-US, es-ES, es-MX, fr-FR, id-ID, it-IT, ja-JP, ko-KR, pl-PL, pt-BR, ru-RU, th-TH, tr-TR, vi-VN, zh-CN, zh-TW, all.

Request

curl "https://astra.teamfortuna.xyz/v1/agents?language=en-US" \
  -H "User-Agent: MyApp/1.0 (+https://example.com)"

Response

The data field contains an array of agent objects. One representative entry is shown below.

{
  "status": 200,
  "data": [
    {
      "uuid": "41fb69c1-4189-7b37-f117-bcaf1e96f1bf",
      "displayName": "Astra",
      "description": "Ghanaian Agent Astra harnesses the energies of the cosmos to reshape battlefields to her whim. With full command of her astral form and a talent for deep strategic foresight, she's always eons ahead of her enemy's next move.",
      "developerName": "Rift",
      "characterTags": null,
      "displayIcon": "https://valmedia.teamfortuna.xyz/agents/41fb69c1-4189-7b37-f117-bcaf1e96f1bf/displayicon.png",
      "displayIconSmall": null,
      "bustPortrait": "https://valmedia.teamfortuna.xyz/agents/41fb69c1-4189-7b37-f117-bcaf1e96f1bf/fullportrait.png",
      "fullPortrait": "https://valmedia.teamfortuna.xyz/agents/41fb69c1-4189-7b37-f117-bcaf1e96f1bf/fullportrait.png",
      "fullPortraitV2": null,
      "killfeedPortrait": "https://valmedia.teamfortuna.xyz/agents/41fb69c1-4189-7b37-f117-bcaf1e96f1bf/killfeedportrait.png",
      "background": "https://valmedia.teamfortuna.xyz/agents/41fb69c1-4189-7b37-f117-bcaf1e96f1bf/characterbackground.png",
      "backgroundGradientColors": [
        "040126ff"
      ],
      "assetPath": "ShooterGame/Content/Characters/Rift/Rift_PrimaryAsset",
      "isFullPortraitRightFacing": false,
      "isPlayableCharacter": true,
      "isAvailableForTest": true,
      "isBaseContent": true,
      "role": {
        "uuid": "4ee40330-ecdd-4f2f-98a8-eb1243428373",
        "displayName": "Controller",
        "description": "Controllers are experts in slicing up dangerous territory to set their team up for success.",
        "displayIcon": null,
        "assetPath": "ShooterGame/Content/Characters/_Core/Roles/Strategist_PrimaryDataAsset"
      },
      "recruitmentData": null,
      "abilities": [
        {
          "slot": "Ability1",
          "displayName": "Nova Pulse",
          "description": "Place Stars in Astral Form (Ultimate Key).\r\n\r\nACTIVATE a Star to detonate a Nova Pulse. The Nova Pulse charges briefly then strikes, Concussing all players in its area.",
          "displayIcon": "./assets/agents/41fb69c1-4189-7b37-f117-bcaf1e96f1bf/abilities/displayicon.png"
        }
      ],
      "voiceLine": null
    }
  ]
}

Get single agent

Retrieve a specific agent by their UUID.

Endpoint

GET https://astra.teamfortuna.xyz/v1/agents/{uuid}

Path parameters

string

required

The unique identifier for the agent (e.g. e370fa57-4757-3604-3648-499e1f642d3f).

Query parameters

string

default:"en-US"

Request

curl "https://astra.teamfortuna.xyz/v1/agents/e370fa57-4757-3604-3648-499e1f642d3f?language=en-US" \
  -H "User-Agent: MyApp/1.0 (+https://example.com)"

When fetching a single agent, the data field in the response is an object rather than an array. The structure of the object is identical to individual entries returned by the list endpoint.

System

Agents & Characters

Cosmetics

Weapons

Game Data

Premier

Localization

Agents & Roles API — GET /v1/agents endpoints

List all agents

Endpoint

Query parameters

Request

Response

Get single agent

Endpoint

Path parameters

Query parameters

Request

​List all agents

​Endpoint

​Query parameters

​Request

​Response

​Get single agent

​Endpoint

​Path parameters

​Query parameters

​Request

List all agents

Endpoint

Query parameters

Request

Response

Get single agent

Endpoint

Path parameters

Query parameters

Request