GunSpec

GameStats

Resource class for interacting with the GunSpec Game Stats Snapshots API. Wraps all /v1/game-stats endpoints. Instantiated internally by the GunSpec client and exposed as client.gameStats.

Auth RequiredBuilder+

client.gameStats.listVersions()

List all available game stats snapshot versions.

listVersions(): Promise<APIResponse<GameStatsVersion[]>>
GET/v1/game-stats/versions

Builder+

  • stringheaderrequired

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

application/json

  • GameStatsVersion[]

    The response payload.

  • integer

    Autoincrementing version id.

  • string

    Version label, e.g. 2025.1.

  • string | null

    Prose summary of the record, where one has been written.

  • integer

    How many firearms carried game statistics in this version.

  • string

    When the record was first added, YYYY-MM-DD HH:MM:SS in UTC.

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

Full rate limits

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.