Buddies API — GET /v1/buddies endpoints

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

string

default:"en-US"

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

number

required

HTTP status code of the response.

object[]

required

Array of buddy objects.

Show buddy properties

string

required

Unique identifier for the buddy.

string

required

Localized display name of the buddy.

boolean

required

Whether this buddy is hidden in the store if the player does not own it.

string

UUID of the cosmetic theme this buddy belongs to. May be null.

string

required

URL of the buddy’s display icon image.

string

required

Internal Unreal Engine asset path.

object[]

required

Array of level objects representing the buddy’s unlock tiers.

Show level properties

string

required

Unique identifier for this level.

number

required

Numeric tier of this level (e.g. 1).

string

required

Localized name for this level.

string

required

URL of the level’s display icon.

string

required

Internal Unreal Engine asset path for this level.

GET /v1/buddies/{uuid}

Returns a single buddy by its UUID.

Path parameters

string

required

The UUID of the buddy to retrieve.

Query parameters

string

default:"en-US"

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

string

default:"en-US"

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

number

required

HTTP status code of the response.

object[]

required

Array of buddy level objects.

Show level properties

string

required

Unique identifier for this buddy level.

number

required

Numeric tier of this level.

string

required

Localized name for this level.

string

required

URL of the level’s display icon.

string

required

Internal Unreal Engine asset path.

GET /v1/buddies/levels/{uuid}

Returns a single buddy level by its UUID.

Path parameters

string

required

The UUID of the buddy level to retrieve.

Query parameters

string

default:"en-US"

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"
      }
    ]
  }
}

System

Agents & Characters

Cosmetics

Weapons

Game Data

Premier

Localization

Buddies API — GET /v1/buddies endpoints

GET /v1/buddies

Query parameters

Example request

Response

Response fields

GET /v1/buddies/{uuid}

Path parameters

Query parameters

Example request

Response

GET /v1/buddies/levels

Query parameters

Example request

Response

Response fields

GET /v1/buddies/levels/{uuid}

Path parameters

Query parameters

Example request

Response

​GET /v1/buddies

​Query parameters

​Example request

​Response

​Response fields

​GET /v1/buddies/{uuid}

​Path parameters

​Query parameters

​Example request

​Response

​GET /v1/buddies/levels

​Query parameters

​Example request

​Response

​Response fields

​GET /v1/buddies/levels/{uuid}

​Path parameters

​Query parameters

​Example request

​Response

GET /v1/buddies

Query parameters

Example request

Response

Response fields

GET /v1/buddies/{uuid}

Path parameters

Query parameters

Example request

Response

GET /v1/buddies/levels

Query parameters

Example request

Response

Response fields

GET /v1/buddies/levels/{uuid}

Path parameters

Query parameters

Example request

Response