Role Roster
Returns the firearms best suited to a gameplay role, scored against that role weighting of the game stats.
- stringheaderrequired
Your API key.
Authorization: Bearer <key>is accepted in its place.
- stringrequired
Gameplay role
- Accepts
- Example
- integerdefault
5How many to return
- Range
- 1 – 25
- Example
- object[]
The best-scoring firearms for the role, strongest first.
- string
Slug of the firearm.
- string
Display name, as the maker writes it.
- number
Fit for this role, 0 to 100, from the role weighting of the game stats.
- object
The editorial game stats, with the
gameprefix the column carries stripped. - integer | null
Editorial damage rating, 0-100. Not a measured figure.
- integer | null
Editorial accuracy rating, 0-100.
- integer | null
Editorial range rating, 0-100.
- integer | null
Editorial rate-of-fire rating, 0-100.
- integer | null
Editorial mobility rating, 0-100.
- integer | null
Editorial recoil-control rating, 0-100.
- integer | null
Editorial reload-speed rating, 0-100.
- integer | null
Editorial concealment rating, 0-100.
- 400
VALIDATION_ERRORValidation error - 401
UNAUTHORIZEDAPI key required - 403
FORBIDDENValid key, not permitted - 429
RATE_LIMITEDRate limit exceeded - 500
INTERNAL_ERRORUnexpected server error
Requires Builder tier or higher.
Valid roles: sniper, assault, tank, support, stealth, speedster.
Each role uses different stat weights for scoring (e.g. sniper: range 0.30, accuracy 0.25, damage 0.25).
Use this to auto-populate role-based loadout screens in your game.
- Minimum tier
- Builder+
- Monthly quota
- 25,000/mo
- Rate limit
- 60/min
- Daily cap
- 2,000
Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.