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
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
The unique identifier for the agent (e.g. e370fa57-4757-3604-3648-499e1f642d3f).
Query parameters
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/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.
