Auth RequiredExplorer+
client.categories.list()
List all firearm categories.
list(): Promise<APIResponse<Category[]>>- stringheaderrequired
Your API key.
Authorization: Bearer <key>is accepted in its place.
- Category[]
The response payload.
- string
URL-safe slug identifying the category, e.g.
pistol. - string
Display name, as the maker writes it.
- string | null
Prose summary of the record, where one has been written.
- 400
VALIDATION_ERRORValidation error - 401
UNAUTHORIZEDAPI key required - 403
FORBIDDENValid key, not permitted - 429
RATE_LIMITEDRate limit exceeded - 500
INTERNAL_ERRORUnexpected server error
- Minimum tier
- Explorer+
- Monthly quota
- 200/mo
- Rate limit
- 10/min
- Daily cap
- 50
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.