Manufacturers

Get manufacturer statistics

Returns aggregate figures for one manufacturer: how many firearms, which categories and calibers they span, and the range of years covered.

Requires Builder tier or higher.

get/v1/manufacturers/{id}/stats

Request

  • Base URL: https://api.gunspec.io
  • URL: https://api.gunspec.io/v1/manufacturers/{id}/stats
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

idstring required

Manufacturer slug

Response

Get manufacturer statistics

successboolean required

Always true on a successful response. Every error carries false and an error object instead.

Example response

{
  "success": true,
  "data": {
    "manufacturer": {
      "id": "glock",
      "name": "Glock Ges.m.b.H."
    },
    "stats": {
      "total_firearms": 134,
      "avg_weight_g": 669.59,
      "avg_range_m": 48.32,
      "avg_capacity": 13.31,
      "active_count": 97,
      "discontinued_count": 37,
      "earliest_year": 1982,
      "latest_year": 2026
    },
    "categories": [
      {
        "id": "pistol",
        "name": "Pistol",
        "count": 134
      }
    ],
    "mostCommonCaliber": {
      "id": "9x19mm-parabellum",
      "name": "9x19mm Parabellum",
      "count": 63
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.