Fortnite Weapon Stats API - Filter by Patch, Category & Gamemode

Why Weapon Stats Matter

Weapon data changes with every Fortnite patch — new guns arrive, old ones get vaulted, and balance changes shift the meta. The Fortnite API exposes the full weapon database with per-patch tracking so you can always show accurate, up-to-date data.

Base URL: https://prod.api-fortnite.com

Auth: x-api-key: YOUR_API_KEY

Weapon Stats Endpoint

GET /api/v2/weapons

Query Parameters

| Parameter | Description |

|-----------|-------------|

| patch | Patch version (e.g. 32.00). Defaults to current patch. |

| category | Category (e.g. Assault, Shotgun, SMG, Sniper) |

| search | Filter by name |

| rarity | Rarity (e.g. rare, epic, legendary) |

| type | Weapon type |

| ammoType | Ammo type filter |

| gamemode | Game mode (e.g. BattleRoyale, ZeroBuild) |

| itemType | Item type filter |

| lang | Language code |

Get Available Patches

GET /api/v2/weapons/patches

Returns all patches for which weapon data is stored, with the current patch flagged:

{
  "status": 200,
  "current": "32.00",
  "patches": [
    { "patch": "32.00", "isCurrent": true },
    { "patch": "31.10", "isCurrent": false },
    ...
  ]
}

Get Rarity Definitions

GET /api/v2/weapons/rarity

Returns rarity display names and their associated colors.

Example: All Shotguns in the Current Patch

const res = await fetch(
  "https://prod.api-fortnite.com/api/v2/weapons?category=Shotgun",
  { headers: { "x-api-key": process.env.FORTNITE_API_KEY } }
);
const { data } = await res.json();

data.forEach((weapon) => {
  console.log(`${weapon.name} (${weapon.rarity})`);
});

Example: Zero Build Weapons Only

const res = await fetch(
  "https://prod.api-fortnite.com/api/v2/weapons?gamemode=ZeroBuild",
  { headers: { "x-api-key": process.env.FORTNITE_API_KEY } }
);
const { data } = await res.json();

Example: Weapon Data for a Specific Patch

const res = await fetch(
  "https://prod.api-fortnite.com/api/v2/weapons?patch=31.10",
  { headers: { "x-api-key": process.env.FORTNITE_API_KEY } }
);
const { data } = await res.json();

Common Use Cases

Performance Tips

Related Guides