GunSpec

Firearms

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

Auth RequiredStudio+

Get Schematics

Returns exploded-view and technical schematic drawings for a firearm.

GET/v1/firearms/{id}/schematics

Studio+

  • stringheaderrequired

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

  • stringrequired

    Firearm slug

    Accepts
    a lowercase slug: letters, digits and hyphens
    Example

application/json

  • FirearmSchematic[]

    The response payload.

  • integer

    Autoincrementing schematic id.

  • string

    Slug of the firearm this row belongs to.

  • string

    What the document is called.

  • SchematicType

    What a schematic document is.

  • string

    Absolute, directly fetchable URL.

  • string | null

    File format, e.g. pdf.

  • string | null

    Revision of the document, where the publisher versions it.

  • string | null

    Publisher of the document, often but not always the maker.

  • string | null

    Where the document came from.

  • string | null

    Page the asset or document was taken from.

  • string | null

    Who made the asset, where it is credited.

  • string | null

    Licence the asset is held under, where one is recorded.

  • 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
  • 404NOT_FOUNDResource not found
  • 429RATE_LIMITEDRate limit exceeded
  • 500INTERNAL_ERRORUnexpected server error

Requires Studio tier or higher. The same documents are embedded in the firearm detail response for Studio+ keys.

url is a path on the assets CDN. Prefix it with https://assets.gunspec.io to fetch the file.

Only Studio+ keys receive these URLs, and paths include an unguessable segment, so documents cannot be enumerated. The files themselves are served from the public CDN, so treat the URL as a shareable link, not a secret.

Reused documents carry source / author / license. Honour the license when you redistribute.

Full rate limits

Minimum tier
Studio+
Monthly quota
150,000/mo
Rate limit
120/min
Daily cap
10,000

Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.