Firearms

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

Resource slug ID

Accepts

a lowercase slug: letters, digits and hyphens

Example

glock-17-gen5

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.

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

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

GLB model, or null where none is on file.

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

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.

Muzzle energy in joules exactly as the source stated it.

Effective range in metres exactly as the source stated it.

Maximum range in metres exactly as the source stated it.

Where the ballistics figures came from, named in prose.

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

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

Display name, as the maker writes it.

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

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

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.

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

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

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

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.

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

Unloaded weight in grams, without magazine.

Loaded weight in grams, with a full magazine.

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

Barrel length in millimetres, measured from the breech face.

Height in millimetres, including sights and a fitted magazine.

Width in millimetres at the widest point.

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

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.

What releases the striker or hammer: striker_fired, hammer_fired.

Trigger arrangement: single_action, double_action, safe_action.

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

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

Magazine pattern: detachable_box, internal, drum, belt.

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

Muzzle energy in joules, for the default load.

Effective range in metres against a point target.

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

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

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

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

Number of grooves cut in the bore.

What the frame or receiver is made of.

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

What the barrel is made of.

What the stock or furniture is made of.

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

JSON array of safety mechanisms

JSON array of features

JSON array of feed systems

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

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

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

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

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

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

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

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

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

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

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

Length with stock folded (mm)

JSON array of alternate names/designations

JSON array of firing modes

JSON array of conflict objects with name, years, and sides

JSON object with estimated_total, production_years, and notes

Historical trivia / game-dev flavor text

JSON array of source URLs the record was compiled from. Check a specific figure against these rather than against dataConfidence.

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.

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

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.

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.

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.

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

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

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.

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

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

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

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

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

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

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

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

Every cartridge this firearm is chambered for, primary first.

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

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.

Display name, as the maker writes it.

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

Bullet diameter in millimetres.

Case length in millimetres.

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.

Case neck outside diameter in millimetres.

Bottleneck cases only.

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

Rim diameter in millimetres.

Rim thickness in millimetres.

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

Autoincrementing image id. Numeric, unlike the catalog slugs.

Slug of the firearm this row belongs to.

Absolute, directly fetchable URL.

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

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

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

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

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

Who made the asset, where it is credited.

Page the asset or document was taken from.

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

Pixel width, where it is known.

Forces and agencies that have adopted it.

Autoincrementing row id.

Slug of the firearm this row belongs to.

The force, agency or organisation that adopted it.

What kind of user: military, police, civilian.

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

Year of adoption, where it is known.

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

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

Autoincrementing schematic id.

Slug of the firearm this row belongs to.

What the document is called.

What a schematic document is.

Absolute, directly fetchable URL.

File format, e.g. pdf.

Revision of the document, where the publisher versions it.

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

Where the document came from.

Page the asset or document was taken from.

Who made the asset, where it is credited.

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