Power Rating
Returns firearms scored on a 0-100 composite of muzzle energy (30%), effective range (25%), rate of fire (20%), magazine capacity (15%), and mobility (10%). Firearms without a recorded muzzle energy are excluded.
- stringheaderrequired
Your API key.
Authorization: Bearer <key>is accepted in its place.
- string
Restrict the ranking to a category slug
- Example
- integerdefault
1Page number, from 1 to 10,000
- Range
- 1 – 10000
- Example
- integerdefault
20Items per page (max 100)
- Range
- 1 – 100
- Example
- object[]
One page of results
- string
Slug of the firearm.
- string
Display name, as the maker writes it.
- string
Slug of the manufacturer that makes it. Resolve against
/v1/manufacturers/{id}. - string
Slug of the category it belongs to. Resolve against
/v1/categories. - number
Composite score from 0 to 100, the sum of the weighted components in
breakdown. - object
The weighted components
powerRatingis the sum of. - number
Muzzle-energy component, out of 30.
- number
Effective-range component, out of 25.
- number
Rate-of-fire component, out of 20.
- number
Magazine-capacity component, out of 15.
- number
Mobility component, out of 10. Lighter and shorter scores higher.
- number
Current page number
- number
Items per page
- number
Total matching records (Builder and above)
- 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.
Power rating is a weighted composite: muzzle energy (35%), effective range (25%), rate of fire (20%), magazine capacity (20%).
Firearms missing required spec fields are excluded from rankings.
Results are sorted by power_rating descending.
- 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.
This read answers conditional requests. Keep the ETag from a response and send it back as If-None-Match: an unchanged record returns 304 Not Modified with no body, which counts toward your per-minute rate limit but not your daily allowance.