GunSpec

Firearms

Browse, search, compare, and retrieve detailed specifications for over 9,000+ firearms including variants.

Auth RequiredExplorer+

Get Adoption Records

Returns the military and law-enforcement operators recorded as using this firearm.

GET/v1/firearms/{id}/users

Explorer+

  • stringheaderrequired

    Your API key. Authorization: Bearer <key> is accepted in its place.

  • stringrequired

    Resource slug ID

    Accepts
    a lowercase slug: letters, digits and hyphens
    Example

application/json

  • FirearmUser[]

    The response payload.

  • integer

    Autoincrementing row id.

  • string

    Slug of the firearm this row belongs to.

  • string

    The force, agency or organisation that adopted it.

  • string | null

    What kind of user: military, police, civilian.

  • string | null

    ISO 3166-1 alpha-2 code of the user's country.

  • integer | null

    Year of adoption, where it is known.

  • string | null

    What that user calls it, where it differs from the maker's name.

  • 400VALIDATION_ERRORValidation error
  • 401UNAUTHORIZEDAPI key required
  • 403FORBIDDENValid key, not permitted
  • 404NOT_FOUNDResource not found
  • 429RATE_LIMITEDRate limit exceeded
  • 500INTERNAL_ERRORUnexpected server error

Full rate limits

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.