Matchups
Returns a per-stat verdict between two firearms using their game-balance stats, plus the overall tally.
- stringheaderrequired
Your API key.
Authorization: Bearer <key>is accepted in its place.
- stringrequired
First firearm slug
- Max length
- 255
- Example
- stringrequired
Second firearm slug
- Max length
- 255
- Example
- object
The response payload.
- object
The firearm named by the
aparameter. - string
Slug of the first firearm.
- string
Display name, as the maker writes it.
- object
The editorial game stats, with the
gameprefix the column carries stripped. - object
The firearm named by the
bparameter. - string
Slug of the second firearm.
- string
Display name, as the maker writes it.
- object
The editorial game stats, with the
gameprefix the column carries stripped. - object
The per-stat verdict, keyed by stat rather than listed.
- string
Which firearm wins on damage:
a,b, ordraw. - string
Which firearm wins on accuracy.
- string
Which firearm wins on range.
- string
Which firearm wins on rate of fire.
- string
Which firearm wins on mobility.
- string
Which firearm wins on recoil control.
- string
Which firearm wins on reload speed.
- string
Which firearm wins on concealment.
- integer
How many statistics the first firearm wins.
- integer
How many statistics the second firearm wins.
- integer
How many statistics are tied.
- 400
VALIDATION_ERRORValidation error - 401
UNAUTHORIZEDAPI key required - 403
FORBIDDENValid key, not permitted - 404
NOT_FOUNDResource not found - 429
RATE_LIMITEDRate limit exceeded - 500
INTERNAL_ERRORUnexpected server error
Requires Builder tier or higher.
Verdicts cover all 8 game stats: damage, accuracy, range, fireRate, mobility, recoilControl, reloadSpeed, concealment. Each value is a, b or draw.
- 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.