GunSpec

Firearms

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

Auth RequiredBuilder+

Returns the glTF binary (.glb) for a firearm, ready to drop into a three.js or Babylon scene. Models are Draco-free but meshopt-compressed and carry WebP textures, so a loader needs EXT_meshopt_compression, EXT_texture_webp and KHR_mesh_quantization: all three are standard glTF extensions. Models we host on the asset CDN answer with a 302 to their location, the same as the image routes; models uploaded to our own bucket stream from here. 404 when the firearm has no model. use has_3d_model=true on /v1/firearms to list the ones that do.

GET/v1/firearms/{id}/model

  • stringheaderrequired

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

  • stringrequired

    Firearm slug

    Accepts
    a lowercase slug: letters, digits and hyphens
    Example

  • 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.