Collections

Optional. Without a key this endpoint answers under the public policy; a key raises your limits and unlocks plan-gated fields. Authorization: Bearer <key> is accepted in its place.

10-character public share id

Accepts

letters and digits

Example

a1b2c3d4e5

The response payload.

Internal id of the collection. Not a credential; the share id is.

Display name, as the maker writes it.

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

The 10-character public share id, echoing the path parameter.

How many firearms the collection holds.

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

The rows this response carries.

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.

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