Ammunition

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 the load name, designation, maker or cartridge name

Max length

200

Example

federal

Filter by caliber slug

Example

9x19mm-parabellum

Filter by bullet construction

Example

fmj

Restrict to commonly stocked loads (1) or uncommon ones (0)

Range

0 – 1

Example

1

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. Maintained by the database rather than by whatever wrote the row, so it moves for a corrected figure and does not move for a re-run of the seed. Before migration 0113 the seed rewrote every load on every run, and this said so.

Where the figures came from. Null on every load today: this family has somewhere to cite from and nothing cited yet, which the data quality page counts as a gap rather than hiding. Check a velocity against the maker until it is filled.

How well specified the load is, on the same 0 to 1 scale as a firearm's. Null until there are sources behind it: a confidence figure with nothing supporting it looks like evidence and is not.

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 first cited page on the record's own manufacturer's website, or null when it cites none. A page on another maker's site does not count. Cited from the maker is not the same as checked against it: verifiedFields names the figures that were read against a source.

How far the record's figures are backed, strongest first, for a badge: verified when at least one figure was read against a source (verifiedFields), maker when it cites a page on its own manufacturer's site (makerSource), authority when it cites a maker, standards body or government page, secondary when it cites only press, retailers, references or forums, none when it cites nothing. Derived from the fields beside it.

The checks the record has been through, on a single record's response only: every task the data agent (Redback) or a person was given about it, what each proposed, the pages it read, and whether a person accepted it. Nothing an agent proposes reaches the record until a person accepts it, so this is the trail behind verifiedFields. Who reviewed is not published; an agent's instance name is.

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.

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)