Calibers

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

Substring match on caliber name or alias

Max length

200

Example

9mm

Filter by cartridge type

Example

centerfire

Filter by primer type

Example

boxer

One page of results

URL-safe slug identifying the cartridge, e.g. 9x19mm-parabellum.

Display name, as the maker writes it.

JSON array of aliases

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

Bullet diameter in millimetres.

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.

Case length in millimetres.

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

Typical projectile length.

Maximum average pressure in megapascals, as the standards body specifies it.

The same pressure in pounds per square inch, converted.

Representative bullet weight in grams. Divide by 0.0648 for grains.

Representative muzzle velocity in metres per second.

Representative muzzle energy in joules.

Primer size and type, e.g. small_pistol, large_rifle, rimfire.

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 profile: straight, bottleneck, tapered, belted.

What the case is made of: brass, steel, aluminium, polymer.

none is a blank.

Bullet shape: fmj, hollow_point, soft_point, spitzer, round_nose.

What seals the case mouth; a blank is a star crimp.

Paint that identifies the load: crimp lacquer on a blank, tip colour on a military round.

What that colour signifies, where the marking is a standard one.

The cartridge this one was derived from, or null. A wildcat and its parent case, for example.

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

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

Page the dimensions were read from.

The standards body whose figures these are (SAAMI, CIP), where the source names one.

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 a person last checked this record against its source. Null means nobody has: the row is model knowledge until then.

JSON array of the fields the source stated.

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.

Current page number

Items per page

Total matching records (Builder and above)

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

Substring match on caliber name or alias

Max length

200

Example

9mm

Filter by cartridge type

Example

centerfire

Filter by primer type

Example

boxer

One page of results

URL-safe slug identifying the cartridge, e.g. 9x19mm-parabellum.

Display name, as the maker writes it.

JSON array of aliases

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

Bullet diameter in millimetres.

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.

Case length in millimetres.

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

Typical projectile length.

Maximum average pressure in megapascals, as the standards body specifies it.

The same pressure in pounds per square inch, converted.

Representative bullet weight in grams. Divide by 0.0648 for grains.

Representative muzzle velocity in metres per second.

Representative muzzle energy in joules.

Primer size and type, e.g. small_pistol, large_rifle, rimfire.

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 profile: straight, bottleneck, tapered, belted.

What the case is made of: brass, steel, aluminium, polymer.

none is a blank.

Bullet shape: fmj, hollow_point, soft_point, spitzer, round_nose.

What seals the case mouth; a blank is a star crimp.

Paint that identifies the load: crimp lacquer on a blank, tip colour on a military round.

What that colour signifies, where the marking is a standard one.

The cartridge this one was derived from, or null. A wildcat and its parent case, for example.

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

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

Page the dimensions were read from.

The standards body whose figures these are (SAAMI, CIP), where the source names one.

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 a person last checked this record against its source. Null means nobody has: the row is model knowledge until then.

JSON array of the fields the source stated.

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.

Current page number

Items per page

Total matching records (Builder and above)

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

Comma-separated caliber slugs, maximum 5

Example

9x19mm-parabellum,45-acp

The response payload.

The compared cartridges, in the order their ids were given.

URL-safe slug identifying the cartridge, e.g. 9x19mm-parabellum.

Display name, as the maker writes it.

JSON array of aliases

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

Bullet diameter in millimetres.

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.

Case length in millimetres.

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

Per-field differences across the compared cartridges, one entry per numeric field.

Which column the row is about, named as the database names it.

This field on each compared cartridge, in the order the ids were given. Null where that record does not carry the field.

Lowest value across the compared cartridges. Null when fewer than two carry the field.

Highest value across the compared cartridges. Null when fewer than two carry the field.

Spread from the lowest value, as a percentage of it. Null when the minimum is zero or fewer than two carry the field.

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

Caliber slug

Max length

255

Example

9x19mm-parabellum

Maximum distance in metres

Range

1 – 5000

Example

100

The response payload.

The cartridge the profile was computed for.

Slug of the cartridge.

Display name, as the maker writes it.

The distance the figures below are quoted at, echoing the distance parameter.

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

Muzzle energy in joules, for the default load.

Remaining velocity at distanceM, in metres per second.

Remaining energy at distanceM, in joules.

Time of flight to distanceM, in seconds.

Bullet drop below the line of sight at distanceM, in centimetres.

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

Caliber slug

Accepts

a lowercase slug: letters, digits and hyphens

Example

9x19mm-parabellum

The response payload

URL-safe slug identifying the cartridge, e.g. 9x19mm-parabellum.

Display name, as the maker writes it.

JSON array of aliases

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

Bullet diameter in millimetres.

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.

Case length in millimetres.

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

Typical projectile length.

Maximum average pressure in megapascals, as the standards body specifies it.

The same pressure in pounds per square inch, converted.

Representative bullet weight in grams. Divide by 0.0648 for grains.

Representative muzzle velocity in metres per second.

Representative muzzle energy in joules.

Primer size and type, e.g. small_pistol, large_rifle, rimfire.

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 profile: straight, bottleneck, tapered, belted.

What the case is made of: brass, steel, aluminium, polymer.

none is a blank.

Bullet shape: fmj, hollow_point, soft_point, spitzer, round_nose.

What seals the case mouth; a blank is a star crimp.

Paint that identifies the load: crimp lacquer on a blank, tip colour on a military round.

What that colour signifies, where the marking is a standard one.

The cartridge this one was derived from, or null. A wildcat and its parent case, for example.

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

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

Page the dimensions were read from.

The standards body whose figures these are (SAAMI, CIP), where the source names one.

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 a person last checked this record against its source. Null means nobody has: the row is model knowledge until then.

JSON array of the fields the source stated.

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.

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

Caliber slug

Accepts

a lowercase slug: letters, digits and hyphens

Example

9x19mm-parabellum

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}.

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.

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)

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

Caliber slug

Accepts

a lowercase slug: letters, digits and hyphens

Example

9x19mm-parabellum

The response payload.

URL-safe slug identifying the cartridge, e.g. 9x19mm-parabellum.

Display name, as the maker writes it.

JSON array of aliases

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

Bullet diameter in millimetres.

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.

Case length in millimetres.

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

Typical projectile length.

Maximum average pressure in megapascals, as the standards body specifies it.

The same pressure in pounds per square inch, converted.

Representative bullet weight in grams. Divide by 0.0648 for grains.

Representative muzzle velocity in metres per second.

Representative muzzle energy in joules.

Primer size and type, e.g. small_pistol, large_rifle, rimfire.

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 profile: straight, bottleneck, tapered, belted.

What the case is made of: brass, steel, aluminium, polymer.

none is a blank.

Bullet shape: fmj, hollow_point, soft_point, spitzer, round_nose.

What seals the case mouth; a blank is a star crimp.

Paint that identifies the load: crimp lacquer on a blank, tip colour on a military round.

What that colour signifies, where the marking is a standard one.

The cartridge this one was derived from, or null. A wildcat and its parent case, for example.

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

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

Page the dimensions were read from.

The standards body whose figures these are (SAAMI, CIP), where the source names one.

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 a person last checked this record against its source. Null means nobody has: the row is model knowledge until then.

JSON array of the fields the source stated.

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.

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

Caliber slug

Accepts

a lowercase slug: letters, digits and hyphens

Example

9x19mm-parabellum

The response payload.

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

URL-safe slug identifying the cartridge, e.g. 9x19mm-parabellum.

Display name, as the maker writes it.

JSON array of aliases

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

Bullet diameter in millimetres.

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.

Case length in millimetres.

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

URL-safe slug identifying the cartridge, e.g. 9x19mm-parabellum.

Display name, as the maker writes it.

JSON array of aliases

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

Bullet diameter in millimetres.

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.

Case length in millimetres.

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

Every cartridge derived from this one, up to 50 rows.

URL-safe slug identifying the cartridge, e.g. 9x19mm-parabellum.

Display name, as the maker writes it.

JSON array of aliases

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

Bullet diameter in millimetres.

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.

Case length in millimetres.

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

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

Caliber slug

Accepts

a lowercase slug: letters, digits and hyphens

Example

9x19mm-parabellum

Page number, from 1 to 10,000

Range

1 – 10000

Example

1

Items per page (max 100)

Range

1 – 100

Example

20

A specific factory ammunition load within a caliber.

URL-safe slug identifying the load, e.g. 9mm-124gr-fmj.

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

Display name, as the maker writes it.

Military or standards designation for the load, e.g. M882.

Who makes it.

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

Bullet weight in grams. Divide by 0.0648 for grains.

Bullet construction: fmj, jhp, sp, match.

Ballistic coefficient against the G1 drag model, the convention for flat-based bullets.

Ballistic coefficient against the G7 drag model, which fits boat-tail rifle bullets better than G1.

Muzzle velocity in metres per second at the reference barrel length below, not at the barrel of any particular firearm.

Barrel length in millimetres the reference velocity was measured from. Velocity for another barrel is extrapolated from this pair.

Bullet mass divided by the square of its diameter. Higher penetrates better, all else equal.

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

1 when the load is commonly stocked.

Absolute URL of the rendered bullet diagram.

Decay exponent used when extrapolating velocity to a barrel length other than the reference one.

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

1 when the load is a military issue round.

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

When a field we serve last changed, YYYY-MM-DD HH:MM:SS in UTC.

Current page number

Items per page

Total matching records (Builder and above)