Firearms

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

Firearm slug

Accepts

a lowercase slug: letters, digits and hyphens

Example

akm

The firearm plus its ancestor and descendant variants, walked recursively.

The parent chain, nearest first, up to 20 deep.

URL-safe slug identifying the related firearm, e.g. type-58.

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.

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.

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

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.

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.

Everything derived from it, breadth-first, up to 50 rows.

URL-safe slug identifying the related firearm, e.g. type-58.

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.

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.

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

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.