GunSpec

Firearms

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

Auth RequiredBuilder+

Returns the image bytes for one gallery entry. Defaults to the raw file with an immutable cache header; format=datauri returns a base64 data URI that drops straight into an <img src> with no second request. Images we link rather than host (external sources, asset-CDN paths) answer with a 302 to their location. Listing images and their credits is explorer-tier via /v1/firearms/{id}/images; the bytes are builder-tier, like the silhouette.

GET/v1/firearms/{id}/images/{imageId}

  • stringheaderrequired

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

  • stringrequired

    Resource slug ID

    Accepts
    a lowercase slug: letters, digits and hyphens
    Example
  • stringrequired

    Image row id from /v1/firearms/{id}/images

    Example

  • stringdefaultraw

    raw file, or a base64 data URI

    Accepts
    Example
  • stringdefaultoriginal

    Pre-rendered derivative; falls back to the original when absent

    Accepts
    Example

  • object

    The response payload.

  • string

    Slug of the firearm the image belongs to.

  • integer

    Numeric id of the image within that firearm image set.

  • string

    Size rendered: original, display or thumb.

  • string

    Encoding of the returned image. datauri is the only format this route emits.

  • string

    Media type of the encoded bytes.

  • string

    The image inlined as an RFC 2397 data URI, ready to use as an <img src> with no second request.

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