Buddies are cosmetic weapon charms that players attach to their guns in Valorant. The Buddies API gives you access to every buddy in the game, including their unlock tiers (levels), display icons, and localized names. You can query the full list or retrieve a single buddy — and its levels — by UUID.
All requests must include a User-Agent header in the format AppName/Version (+URL). Requests without it will be rejected.
GET /v1/buddies Returns a list of all weapon buddies.
Use the language query parameter to receive localized displayName values in the language of your choice.
Query parameters BCP 47 locale string for response localization. Example: ja-JP, de-DE, fr-FR.
Example request curl --request GET \ --url "https://astra.teamfortuna.xyz/v1/buddies?language=en-US" \ --header "User-Agent: MyApp/1.0 (+https://example.com)"
Response { "status" : 200 , "data" : [ { "uuid" : "f79a3078-4c13-d7da-cb6e-d3bb8a4ddcbe" , "displayName" : "¡Rico, po! Buddy" , "isHiddenIfNotOwned" : true , "themeUuid" : null , "displayIcon" : "https://valmedia.teamfortuna.xyz/buddies/f79a3078-4c13-d7da-cb6e-d3bb8a4ddcbe/displayicon.png" , "assetPath" : "ShooterGame/Content/Equippables/Buddies/EmpanadaDePino/GunBuddy_EmpanadaDePino_PrimaryAsset" , "levels" : [ { "uuid" : "663901dc-4c1f-edc9-1768-f7a2ad92a865" , "charmLevel" : 1 , "hideIfNotOwned" : false , "displayName" : "¡Rico, po! Buddy" , "displayIcon" : null , "assetPath" : "ShooterGame/Content/Equippables/Buddies/EmpanadaDePino/GunBuddy_EmpanadaDePino_Lv1_PrimaryAsset" } ] } ] }
Response fields HTTP status code of the response.
Array of buddy objects. Unique identifier for the buddy.
Localized display name of the buddy.
Whether this buddy is hidden in the store if the player does not own it.
UUID of the cosmetic theme this buddy belongs to. May be null.
URL of the buddy’s display icon image.
Internal Unreal Engine asset path.
Array of level objects representing the buddy’s unlock tiers. Unique identifier for this level.
Numeric tier of this level (e.g. 1).
Localized name for this level.
URL of the level’s display icon.
Internal Unreal Engine asset path for this level.
GET /v1/buddies/{uuid} Returns a single buddy by its UUID.
Path parameters The UUID of the buddy to retrieve.
Query parameters BCP 47 locale string for response localization.
Example request curl --request GET \ --url "https://astra.teamfortuna.xyz/v1/buddies/f79a3078-4c13-d7da-cb6e-d3bb8a4ddcbe?language=en-US" \ --header "User-Agent: MyApp/1.0 (+https://example.com)"
Response { "status" : 200 , "data" : { "uuid" : "f79a3078-4c13-d7da-cb6e-d3bb8a4ddcbe" , "displayName" : "¡Rico, po! Buddy" , "isHiddenIfNotOwned" : true , "themeUuid" : null , "displayIcon" : "https://valmedia.teamfortuna.xyz/buddies/f79a3078-4c13-d7da-cb6e-d3bb8a4ddcbe/displayicon.png" , "assetPath" : "ShooterGame/Content/Equippables/Buddies/EmpanadaDePino/GunBuddy_EmpanadaDePino_PrimaryAsset" , "levels" : [ { "uuid" : "663901dc-4c1f-edc9-1768-f7a2ad92a865" , "charmLevel" : 1 , "hideIfNotOwned" : false , "displayName" : "¡Rico, po! Buddy" , "displayIcon" : null , "assetPath" : "ShooterGame/Content/Equippables/Buddies/EmpanadaDePino/GunBuddy_EmpanadaDePino_Lv1_PrimaryAsset" } ] } }
GET /v1/buddies/levels Returns a flat list of all buddy levels across every buddy in the game. This is useful when you need to look up a level directly by its own UUID without knowing the parent buddy first.
Query parameters BCP 47 locale string for response localization.
Example request curl --request GET \ --url "https://astra.teamfortuna.xyz/v1/buddies/levels?language=en-US" \ --header "User-Agent: MyApp/1.0 (+https://example.com)"
Response { "status" : 200 , "data" : [ { "uuid" : "663901dc-4c1f-edc9-1768-f7a2ad92a865" , "charmLevel" : 1 , "hideIfNotOwned" : false , "displayName" : "¡Rico, po! Buddy" , "displayIcon" : null , "assetPath" : "ShooterGame/Content/Equippables/Buddies/EmpanadaDePino/GunBuddy_EmpanadaDePino_Lv1_PrimaryAsset" } ] }
Response fields HTTP status code of the response.
Array of buddy level objects. Unique identifier for this buddy level.
Numeric tier of this level.
Localized name for this level.
URL of the level’s display icon.
Internal Unreal Engine asset path.
GET /v1/buddies/levels/{uuid} Returns a single buddy level by its UUID.
Path parameters The UUID of the buddy level to retrieve.
Query parameters BCP 47 locale string for response localization.
Example request curl --request GET \ --url "https://astra.teamfortuna.xyz/v1/buddies/f79a3078-4c13-d7da-cb6e-d3bb8a4ddcbe?language=en-US" \ --header "User-Agent: MyApp/1.0 (+https://example.com)"
Response { "st{ " status ": 200, " data ": { " uuid ": " f79a3078-4c13-d7da-cb6e-d3bb8a4ddcbe ", " displayName ": " ¡Rico, po! Buddy ", " isHiddenIfNotOwned ": true, " themeUuid ": null, " displayIcon ": " https : //valmedia.teamfortuna.xyz/buddies/f79a3078-4c13-d7da-cb6e-d3bb8a4ddcbe/displayicon.png", "assetPath" : "ShooterGame/Content/Equippables/Buddies/EmpanadaDePino/GunBuddy_EmpanadaDePino_PrimaryAsset" , "levels" : [ { "uuid" : "663901dc-4c1f-edc9-1768-f7a2ad92a865" , "charmLevel" : 1 , "hideIfNotOwned" : false , "displayName" : "¡Rico, po! Buddy" , "displayIcon" : null , "assetPath" : "ShooterGame/Content/Equippables/Buddies/EmpanadaDePino/GunBuddy_EmpanadaDePino_Lv1_PrimaryAsset" } ] } }
