Firearms

• X-API-Keystringheaderrequired

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

• idstringrequired

  Resource slug ID

  Accepts

  a lowercase slug: letters, digits and hyphens

  Example

  glock-g17-gen5

The example asks for glock-g17-gen5. See that record on gunspec.io, rendered for people.

• dataFirearmDetail

  A firearm as stored: every specification column we serve, with no nested relations. FirearmDetail is this plus them, and /v1/firearms/{id}/family-tree returns this shape for current, since the walk reads the row and does not load the relations.

• data.has3dModelinteger

  Integer flag, 1 when a 3D model is on file. Stored as the database holds it rather than as a boolean.

• data.svgLineArtUrlstring | null

  Line-art silhouette, or null where none has been drawn.

• data.model3dUrlstring | null

  GLB model, or null where none is on file.

• data.defaultAmmoIdstring | null

  The ammunition load ballistics figures are quoted against, where one is nominated.

• data.sourceMuzzleVelocityMpsnumber | null

  Muzzle velocity in metres per second exactly as the source stated it, kept beside our own figure so a reader can see what was quoted and what was derived.

• data.sourceMuzzleEnergyJnumber | null

  Muzzle energy in joules exactly as the source stated it.

• data.sourceEffectiveRangeMnumber | null

  Effective range in metres exactly as the source stated it.

• data.sourceMaxRangeMnumber | null

  Maximum range in metres exactly as the source stated it.

• data.ballisticsSourcestring | null

  Where the ballistics figures came from, named in prose.

• data.ballisticsSourceUrlstring | null

  URL of the ballistics source, where it is a page rather than a book.

• data.idstring

  URL-safe slug identifying the firearm, e.g. glock-g17-gen5. Stable: it is what a mirror keys on.

• data.namestring

  Display name, as the maker writes it.

• data.manufacturerIdstring

  Slug of the manufacturer that makes it. Resolve against /v1/manufacturers/{id}.

• data.categoryIdstring

  Slug of the category it belongs to. Resolve against /v1/categories.

• data.parentFirearmIdstring | null

  The firearm this one is a variant of, or null when it is not a variant. Variant relationships are what firearm.variant.updated webhooks and /v1/firearms/{id}/variants follow.

• data.variantTypestring | null

  How this record differs from its parent: optics_ready, compact, threaded and so on. Null when the record has no parent.

• data.yearIntroducedinteger | null

  Year it entered production or service. Null where the date is disputed or unknown.

• data.yearDiscontinuedinteger | null

  Year production ended, or null while it is still made.

• data.statusFirearmStatus | null

  Production status, one of in_production, discontinued, out_of_production, in_service, limited_production, prototype. Discontinued records are kept deliberately: a rifle built in 2004 wears parts nobody sells today.

• data.countryOfOriginstring | null

  ISO 3166-1 alpha-2 code of where it was designed, e.g. AT.

• data.weightEmptyGnumber | null

  Unloaded weight in grams, without magazine.

• data.weightLoadedGnumber | null

  Loaded weight in grams, with a full magazine.

• data.overallLengthMmnumber | null

  Overall length in millimetres, stock extended where it folds or collapses.

• data.barrelLengthMmnumber | null

  Barrel length in millimetres, measured from the breech face.

• data.heightMmnumber | null

  Height in millimetres, including sights and a fitted magazine.

• data.widthMmnumber | null

  Width in millimetres at the widest point.

• data.sightRadiusMmnumber | null

  Distance between front and rear iron sights in millimetres. Null on a record with no iron sights.

• data.actionTypestring | null

  How the action cycles: short_recoil, gas_operated, blowback, bolt_action and so on. An open vocabulary: the values in use are published on the schema as x-gunspec-vocabulary, and GET /v1/firearms/action-types is the live list.

• data.firingMechanismstring | null

  What releases the striker or hammer: striker_fired, hammer_fired.

• data.triggerTypestring | null

  Trigger arrangement: single_action, double_action, safe_action.

• data.triggerPullNnumber | null

  Trigger pull weight in newtons. Divide by 4.448 for pounds-force.

• data.magazineCapacityinteger | null

  Rounds in the standard magazine. Null where the firearm is not magazine-fed.

• data.magazineTypestring | null

  Magazine pattern: detachable_box, internal, drum, belt.

• data.muzzleVelocityMpsnumber | null

  Muzzle velocity in metres per second, for the default load.

• data.muzzleEnergyJnumber | null

  Muzzle energy in joules, for the default load.

• data.effectiveRangeMnumber | null

  Effective range in metres against a point target.

• data.maxRangeMnumber | null

  Maximum range in metres. Where the projectile lands, not where it is useful.

• data.rateOfFireRpminteger | null

  Cyclic rate in rounds per minute. Null on anything that is not automatic.

• data.barrelRiflingstring | null

  Rifling description, e.g. 6 grooves, right-hand twist.

• data.riflingTwistMmnumber | null

  Rifling twist rate in millimetres per turn. Divide by 25.4 for inches.

• data.numberOfGroovesinteger | null

  Number of grooves cut in the bore.

• data.frameMaterialstring | null

  What the frame or receiver is made of.

• data.slideMaterialstring | null

  What the slide is made of. Null on anything without one.

• data.barrelMaterialstring | null

  What the barrel is made of.

• data.stockMaterialstring | null

  What the stock or furniture is made of.

• data.finishstring | null

  Surface finish, e.g. nitride, parkerized, cerakote.

• data.safetyMechanismsstring[]

  Safety mechanisms the design carries.

• data.featuresstring[]

  Notable features of the design.

• data.feedSystemsstring[]

  How the firearm is fed.

• data.gameDamageinteger | null

  Editorial game statistic, 0-100. Not a measured figure. These are balance numbers for game use and are not derived from the ballistics above.

• data.gameAccuracyinteger | null

  Editorial game statistic, 0-100. Not a measured figure.

• data.gameRangeinteger | null

  Editorial game statistic, 0-100. Not a measured figure.

• data.gameFireRateinteger | null

  Editorial game statistic, 0-100. Not a measured figure.

• data.gameMobilityinteger | null

  Editorial game statistic, 0-100. Not a measured figure.

• data.gameRecoilControlinteger | null

  Editorial game statistic, 0-100. Not a measured figure.

• data.gameReloadSpeedinteger | null

  Editorial game statistic, 0-100. Not a measured figure.

• data.gameConcealmentinteger | null

  Editorial game statistic, 0-100. Not a measured figure.

• data.descriptionstring | null

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

• data.notesstring | null

  Free-text notes that do not belong in a specific field.

• data.designerstring | null

  Person or team credited with the design, where it is known.

• data.foldedLengthMmnumber | null

  Length with stock folded (mm)

• data.alternateNamesstring[]

  Other names and designations the same firearm is known by.

• data.firingModesstring[]

  Firing modes the selector offers.

• data.conflictsobject[]

  Conflicts the firearm saw service in.

• data.conflicts[].namestring

  The conflict.

• data.conflicts[].yearsstring

  When it ran, as written.

• data.conflicts[].sidesstring[]

  The belligerents.

• data.productionNumbersobject | null

  How many were made, and over what period.

• data.productionNumbers.estimated_totalinteger | null

  Units believed produced.

• data.productionNumbers.production_yearsstring | null

  The production run, as written.

• data.productionNumbers.notesstring | null

  What the estimate covers.

• data.lorestring | null

  Historical trivia / game-dev flavor text

• data.sourcesstring[]

  Source URLs the record was compiled from. Check a specific figure against these rather than against dataConfidence. The same list is in provenance.sources.

• data.verifiedAtstring | null

  When a source was last read against the record's figures. Null until one has been. The same value is in provenance.verifiedAt.

• data.verifiedFieldsstring[]

  The figures a source confirmed: read off the manufacturer's own page, within the published tolerance, and accepted by a person. The same list is in provenance.verifiedFields.

• data.dataConfidencenumber | null

  How completely the record is specified and how well it is sourced, 0 to 1. A record-level completeness and provenance measure, not a per-field probability of correctness. Use it to rank and triage; use sources to verify an individual number.

• data.createdAtstring

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

• data.updatedAtstring

  When a field we serve last changed. Maintained by the database rather than by whatever wrote the row, so it moves for a corrected specification and does not move for a re-run of the importer.

• data.versionstring | null

  Opaque fingerprint of this record. It changes when and only when a field we serve changes, so a client holding the same value already has the record and need not fetch it. Equality is the only supported operation: do not parse it, and do not assume how it is computed. Null means the record has not been written since versioning began, not that it is unchanged.

• data.provenanceProvenance

  Where a record's figures came from and how far they have been checked, in one place. sources are the pages consulted; check a specific figure against those. sourceKinds says what each page is and bestSourceKind the strongest of them, on the hierarchy SourceKind defines: a maker or standards-body page is evidence for a figure, a retailer or forum page is evidence the item exists. dataConfidence is the 0 to 1 score set from what was actually sourced and never raised by hand. verifiedAt and verifiedFields say when a source was last read against the record and which fields it stated; null means the row is still seed knowledge. updatedAt and version are the same cache signals the record carries at the top level.

• data.provenance.sourcesstring[]

  The pages consulted when the record was compiled, as an array. Check a specific figure against these rather than against dataConfidence.

• data.provenance.sourceKindsobject[]

  What each cited page is, in sources order, on the SourceKind hierarchy. A host not in the source map is other, never guessed.

• data.provenance.bestSourceKindSourceKind | null

  The strongest kind among the citations, or null when nothing is cited. manufacturer or standards_body means a figure can be checked against an authority; retailer or community alone means the record is still supported by copies of copies.

• data.provenance.makerSourcestring | null

  The first cited page on the record's own manufacturer's website, or null when it cites none. A page on another maker's site does not count. Cited from the maker is not the same as checked against it: verifiedFields names the figures that were read against a source.

• data.provenance.evidencestring

  How far the record's figures are backed, strongest first, for a badge: verified when at least one figure was read against a source (verifiedFields), maker when it cites a page on its own manufacturer's site (makerSource), authority when it cites a maker, standards body or government page, secondary when it cites only press, retailers, references or forums, none when it cites nothing. Derived from the fields beside it.

• data.provenance.checksobject

  The checks the record has been through, on a single record's response only: every task the data agent (Redback) or a person was given about it, what each proposed, the pages it read, and whether a person accepted it. Nothing an agent proposes reaches the record until a person accepts it, so this is the trail behind verifiedFields. Who reviewed is not published; an agent's instance name is.

• data.provenance.dataConfidencenumber | null

  The 0 to 1 score set from what was actually sourced, never raised by hand. See the confidence bands in the docs.

• data.provenance.verifiedAtstring | null

  When a source was last read against this record. Null means the row is still seed knowledge.

• data.provenance.verifiedFieldsstring[]

  Which fields the source stated, as an array. Everything else on a verified row is still unverified. Null where no source has been read.

• data.provenance.specSourcestring | null

  Cartridges only: the page the drawing figures were taken from. Null on every other kind of record.

• data.provenance.updatedAtstring

  When a served column last changed; the same value the record carries at the top level.

• data.provenance.versionstring | null

  The record's content version, equal to the top-level version; equal versions mean equal data.

• data.manufacturerManufacturer | null

  Null when the record names a manufacturer id the catalog no longer holds.

• data.categoryCategory | null

  Null when the record names a category id the catalog no longer holds.

• data.calibersFirearmCaliber[]

  Every cartridge this firearm is chambered for, primary first.

• data.calibers[].caliberIdstring

  Slug of the cartridge. Resolve against /v1/calibers/{id}.

• data.calibers[].isPrimaryinteger

  Integer flag, 1 on the chambering the firearm is normally sold in. A firearm may be chambered for several cartridges but has at most one primary.

• data.calibers[].namestring

  Display name, as the maker writes it.

• data.calibers[].natoDesignationstring | null

  NATO designation where the cartridge has one, e.g. 9mm NATO. Null otherwise.

• data.calibers[].bulletDiameterMmnumber | null

  Bullet diameter in millimetres.

• data.calibers[].caseLengthMmnumber | null

  Case length in millimetres.

• data.calibers[].cartridgeTypestring | null

  Head type: rimmed, rimless, semi_rimmed, rebated_rim, belted, plus historical values like cap_and_ball. Not the broad class. The registry said pistol/rifle/shotgun until the column was read, and it holds neither.

• data.calibers[].neckDiameterMmnumber | null

  Case neck outside diameter in millimetres.

• data.calibers[].shoulderDiameterMmnumber | null

  Bottleneck cases only.

• data.calibers[].baseDiameterMmnumber | null

  Case base diameter in millimetres, ahead of the extractor groove.

• data.calibers[].rimDiameterMmnumber | null

  Rim diameter in millimetres.

• data.calibers[].rimThicknessMmnumber | null

  Rim thickness in millimetres.

• data.imagesFirearmImage[]

  Every image on file, silhouette first. Each carries an absolute, directly fetchable url.

• data.images[].idinteger

  Autoincrementing image id. Numeric, unlike the catalog slugs.

• data.images[].firearmIdstring

  Slug of the firearm this row belongs to.

• data.images[].urlstring

  Absolute, directly fetchable URL.

• data.images[].typeImageType | null

  Role of the image: primary, gallery, thumbnail, svg, render.

• data.images[].sourcestring | null

  Where the record came from: a curated entry, an inference, or an import.

• data.images[].licensestring | null

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

• data.images[].kindMediaKind | null

  What the asset is: silhouette, render, photo, schematic, model. /v1/firearms/{id}/media/{selector} addresses an asset by this.

• data.images[].storagestring | null

  Where the bytes live: cdn for a static path, r2 for an upload we serve.

• data.images[].authorstring | null

  Who made the asset, where it is credited.

• data.images[].sourceUrlstring | null

  Page the asset or document was taken from.

• data.images[].altstring | null

  Alt text, where one has been written. Null otherwise, so do not render an empty string.

• data.images[].widthinteger | null

  Pixel width, where it is known.

• data.usersFirearmUser[]

  Forces and agencies that have adopted it.

• data.users[].idinteger

  Autoincrementing row id.

• data.users[].firearmIdstring

  Slug of the firearm this row belongs to.

• data.users[].userNamestring

  The force, agency or organisation that adopted it.

• data.users[].userTypestring | null

  What kind of user: military, police, civilian.

• data.users[].countryCodestring | null

  ISO 3166-1 alpha-2 code of the user's country.

• data.users[].adoptedYearinteger | null

  Year of adoption, where it is known.

• data.users[].designationstring | null

  What that user calls it, where it differs from the maker's name.

• data.schematicsFirearmSchematic[]

  Exploded-view and parts diagrams on file, empty where none have been sourced.

• data.schematics[].idinteger

  Autoincrementing schematic id.

• data.schematics[].firearmIdstring

  Slug of the firearm this row belongs to.

• data.schematics[].titlestring

  What the document is called.

• data.schematics[].typeSchematicType

  What a schematic document is.

• data.schematics[].urlstring

  Absolute, directly fetchable URL.

• data.schematics[].formatstring | null

  File format, e.g. pdf.

• data.schematics[].versionstring | null

  Revision of the document, where the publisher versions it.

• data.schematics[].manufacturerstring | null

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

• data.schematics[].sourcestring | null

  Where the document came from.

• data.schematics[].sourceUrlstring | null

  Page the asset or document was taken from.

• data.schematics[].authorstring | null

  Who made the asset, where it is credited.

• data.schematics[].licensestring | null

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

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