Firearms

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

Page number, from 1 to 10,000

Range

1 – 10000

Example

1

Items per page (max 100)

Range

1 – 100

Example

20

Sort field

Accepts

nameweightyearcalibercreated_atfavorites

Example

name

Sort order

Accepts

ascdesc

Example

asc

Comma-separated list of fields to include

Example

id,name,weightEmptyG

Filter by manufacturer slug

Max length

100

Example

glock

Filter by caliber slug

Example

9x19mm-parabellum

Filter by category slug

Max length

100

Example

pistol

Filter by action type, as stored and underscored. The vocabulary is /v1/firearms/action-types

Example

short_recoil

Filter by ISO 3166-1 alpha-2 country code

Example

AT

Minimum year introduced

Maximum year introduced

Minimum empty weight (grams)

Maximum empty weight (grams)

Minimum barrel length (mm)

Filter by production status

Accepts

in_productiondiscontinuedout_of_productionin_servicelimited_productionprototype

Comma-separated feature slugs; all must match

Example

ambi-safety,m-lok

Only firearms with (or without) a 3D model

Accepts

truefalse

Only firearms with (or without) real imagery: a render or a photograph, ignoring the line-art silhouette every firearm has

Accepts

truefalse

Only records added after this ISO 8601 timestamp

Only records added before this ISO 8601 timestamp

One page of results

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.

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.

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.

Unloaded weight in grams, without magazine.

Barrel length in millimetres, measured from the breech face.

Every image this firearm has, silhouette first. Empty when none are on file.

Autoincrementing image id.

Absolute, directly fetchable URL.

What kind of asset a media row is.

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

Pixel width, where it is known.

Pixel height, where it is known.

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

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

GLB model, or null where none is on file.

How many accounts have favorited this record.

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.

Current page number

Items per page

Total matching records (Builder and above)