Categories

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

The response payload.

URL-safe slug identifying the category, e.g. pistol.

Display name, as the maker writes it.

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

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

Category slug

Accepts

a lowercase slug: letters, digits and hyphens

Example

pistol

Page number, from 1 to 10,000

Range

1 – 10000

Example

1

Items per page (max 100)

Range

1 – 100

Example

20

One page of results

URL-safe slug identifying the firearm, e.g. glock-17-gen5.

Display name, as the maker writes it.

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

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.

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.

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

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

GLB model, or null where none is on file.

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.

Current page number

Items per page

Total matching records (Builder and above)