client.ammunition.listAutoPaging()
Auto-paginate through all ammunition matching the given filters. Returns an async iterator that fetches pages on demand, yielding individual Ammunition objects.
listAutoPaging(params?: ListAmmunitionParams): AsyncIterableIterator<Ammunition>- stringHeadererforderlich
Ihr API-Schlüssel.
Authorization: Bearer <key>wird ebenfalls akzeptiert.
- integerstandard
1Page number, from 1 to 10,000
- Bereich
- 1 – 10000
- Beispiel
- integerstandard
20Items per page (max 100)
- Bereich
- 1 – 100
- Beispiel
- string
Substring match on the load name, designation, maker or cartridge name
- Max. Länge
- 200
- Beispiel
- string
Filter by caliber slug
- Beispiel
- string
Filter by bullet construction
- Beispiel
- integer
Restrict to commonly stocked loads (1) or uncommon ones (0)
- Bereich
- 0 – 1
- Beispiel
- AmmunitionLoad[]
A specific factory ammunition load within a caliber.
- string
URL-safe slug identifying the load, e.g.
9mm-124gr-fmj. - string
Slug of the cartridge. Resolve against
/v1/calibers/{id}. - string
Display name, as the maker writes it.
- string | null
Military or standards designation for the load, e.g.
M882. - string | null
Who makes it.
- string | null
ISO 3166-1 alpha-2 code of where it was designed, e.g.
AT. - number
Bullet weight in grams. Divide by 0.0648 for grains.
- string
Bullet construction:
fmj,jhp,sp,match. - number | null
Ballistic coefficient against the G1 drag model, the convention for flat-based bullets.
- number | null
Ballistic coefficient against the G7 drag model, which fits boat-tail rifle bullets better than G1.
- number
Muzzle velocity in metres per second at the reference barrel length below, not at the barrel of any particular firearm.
- number
Barrel length in millimetres the reference velocity was measured from. Velocity for another barrel is extrapolated from this pair.
- number | null
Bullet mass divided by the square of its diameter. Higher penetrates better, all else equal.
- integer | null
Year it entered production or service. Null where the date is disputed or unknown.
- integer
1 when the load is commonly stocked.
- string | null
Absolute URL of the rendered bullet diagram.
- number | null
Decay exponent used when extrapolating velocity to a barrel length other than the reference one.
- string | null
Prose summary of the record, where one has been written.
- integer
1 when the load is a military issue round.
- string
When the record was first added,
YYYY-MM-DD HH:MM:SSin UTC. - string
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.
- string[]
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.
- number | null
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.
- Provenance
Where a record's figures came from and how far they have been checked, in one place.
sourcesare the pages consulted; check a specific figure against those.sourceKindssays what each page is andbestSourceKindthe strongest of them, on the hierarchySourceKinddefines: a maker or standards-body page is evidence for a figure, a retailer or forum page is evidence the item exists.dataConfidenceis the 0 to 1 score set from what was actually sourced and never raised by hand.verifiedAtandverifiedFieldssay when a source was last read against the record and which fields it stated; null means the row is still seed knowledge.updatedAtandversionare the same cache signals the record carries at the top level. - string[]
The pages consulted when the record was compiled, as an array. Check a specific figure against these rather than against
dataConfidence. - object[]
What each cited page is, in
sourcesorder, on theSourceKindhierarchy. A host not in the source map isother, never guessed. - SourceKind | null
The strongest kind among the citations, or null when nothing is cited.
manufacturerorstandards_bodymeans a figure can be checked against an authority;retailerorcommunityalone means the record is still supported by copies of copies. - string | null
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:
verifiedFieldsnames the figures that were read against a source. - string
How far the record's figures are backed, strongest first, for a badge:
verifiedwhen at least one figure was read against a source (verifiedFields),makerwhen it cites a page on its own manufacturer's site (makerSource),authoritywhen it cites a maker, standards body or government page,secondarywhen it cites only press, retailers, references or forums,nonewhen it cites nothing. Derived from the fields beside it. - object
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. - number | null
The 0 to 1 score set from what was actually sourced, never raised by hand. See the confidence bands in the docs.
- string | null
When a source was last read against this record. Null means the row is still seed knowledge.
- string[]
Which fields the source stated, as an array. Everything else on a verified row is still unverified. Null where no source has been read.
- string | null
Cartridges only: the page the drawing figures were taken from. Null on every other kind of record.
- string
When a served column last changed; the same value the record carries at the top level.
- string | null
The record's content version, equal to the top-level
version; equal versions mean equal data. - string | null
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.
- number
Current page number
- number
Items per page
- number
Total matching records (Builder and above)
- 400
VALIDATION_ERROR - 401
UNAUTHORIZED - 403
FORBIDDEN - 429
RATE_LIMITED - 500
INTERNAL_ERROR
Returns an async iterator: it fetches each page as you consume it, so a loop over the whole collection is one statement and one page in memory at a time.
- Mindeststufe
- Builder+
- Monatskontingent
- 25,000/mo
- Anfragerate
- 60/min
- Tageslimit
- 5,000
Die Werte gelten für die Mindeststufe dieses Endpunkts. Höhere Stufen erhöhen alle Limits.
Dieser Aufruf beantwortet bedingte Anfragen. Speichern Sie das ETag einer Antwort und senden Sie es als If-None-Match zurueck: ein unveraenderter Datensatz liefert 304 Not Modified ohne Body. Das zaehlt auf Ihr Minutenlimit, aber nicht auf Ihr Tageskontingent.