GunSpec

Game Stats Snapshots

Versioned snapshots of game-balance stats. Pin your game to a specific dataset version (e.g., "2026.1") so stat rebalancing doesn't break your build mid-development. When you're ready to pick up new values, switch to a newer version on your own schedule.

Auth RequiredBuilder+

Returns paginated game stats for every firearm frozen into one snapshot version.

GET/v1/game-stats/versions/{version}/firearms

  • stringheaderrequired

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

  • stringrequired

    Snapshot version

    Accepts
    matching ^[a-z0-9][a-z0-9.\-]*$
    Example

  • integerdefault1

    Page number, from 1 to 10,000

    Range
    1 – 10000
    Example
  • integerdefault20

    Items per page (max 100)

    Range
    1 – 100
    Example

  • GameStatsSnapshotEntry[]

    One page of results

  • string

    Slug of the firearm this row is about.

  • string

    Display name at the time the snapshot was taken.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • number

    Current page number

  • number

    Items per page

  • number

    Total matching records (Builder and above)

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

Requires Builder tier or higher.

Stats are frozen: they never change for a given version.

Results are sorted alphabetically by firearm name.

Use per_page=100 to fetch in larger batches for bulk loading.

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.