GunSpec

Manufacturers

Resource class for interacting with the GunSpec Manufacturers API. Wraps all /v1/manufacturers endpoints. Instantiated internally by the GunSpec client and exposed as client.manufacturers.

Auth RequiredBuilder+

Get aggregate statistics for a manufacturer.

getStats(id: string): Promise<APIResponse<ManufacturerStats>>
GET/v1/manufacturers/{id}/stats

  • stringheaderrequired

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

  • stringrequired

    Manufacturer slug

    Accepts
    a lowercase slug: letters, digits and hyphens
    Example

  • object

    The response payload.

  • object

    Who the figures are about.

  • string

    Slug of the manufacturer.

  • string

    Display name, as the maker writes it.

  • object

    The aggregate figures. snake_case, as the rollup query names them.

  • integer

    How many catalogued firearms they make.

  • number | null

    Mean unloaded weight in grams across their catalog, over the firearms that record one.

  • number | null

    Mean effective range in metres, over the firearms that record one.

  • number | null

    Mean magazine capacity, over the firearms that record one.

  • integer

    How many of their firearms are still in production.

  • integer

    How many of their firearms are discontinued.

  • integer | null

    Introduction year of their earliest catalogued firearm. Null when none records one.

  • integer | null

    Introduction year of their most recent catalogued firearm. Null when none records one.

  • object[]

    Categories they build in, most first.

  • string

    Slug of the category.

  • string

    Display name, as the maker writes it.

  • integer

    How many of their firearms are in it.

  • object

    The single cartridge most of their catalog chambers. Null where none of their firearms records a caliber.

  • string

    Slug of the cartridge.

  • string

    Display name, as the maker writes it.

  • integer

    How many of their firearms chamber it.

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

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.