Attachments

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

Attachment category

Max length

100

Example

stock

Manufacturer slug

Max length

100

Example

magpul

Only attachments that fit this firearm

Max length

100

Example

ak-74m

Only attachments requiring this interface standard

Max length

80

Example

rail:m-lok

Substring match on name

Max length

60

Example

pmag

Only factory parts (true) or only aftermarket (false)

Production status. The catalog keeps discontinued parts on purpose, so a store front asks for in_production

Accepts

in_productiondiscontinuedlimited

Example

in_production

Restrict to one seller. me resolves to the vendor your key belongs to

Max length

64

Example

me

Drop anything that seller does not currently stock. Needs a resolvable vendor, and yields nothing without one

One page of results

URL-safe slug identifying the part, e.g. magpul-zhukov-s-stock.

Display name, as the maker writes it.

What kind of part it is: stock, optic, muzzle, magazine, grip.

Who makes it.

The maker's own SKU, where they publish one.

Weight in grams.

Length in millimetres.

Magazines only

Suppressors and muzzle devices

The mount position this part occupies, or null when it takes none.

True when the part ships on the firearm from the factory. A factory part carries no statMods or specDeltas, because the firearm's own figures already include it.

The firearm this is the factory part for, when isFactoryPart is true.

Editorial adjustments to the game statistics once fitted, keyed by stat. Same status as game_* on a firearm: not measured.

Specification changes once fitted, keyed by field: a folding stock changes the folded length, for example.

Absolute URL of the manufacturer product photo on the assets CDN, ready to render. Null when no photo has been sourced yet.

Production status of an attachment. limited corresponds to a firearm's limited_production.

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

Standard ids this adds to the firearm once fitted. Resolved to { id, name, kind } rows on /v1/attachments/{id}.

Current page number

Items per page

Total matching records (Builder and above)

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

Attachment slug

Accepts

a lowercase slug: letters, digits and hyphens

Example

magpul-zhukov-s-stock

The response payload

URL-safe slug identifying the part, e.g. magpul-zhukov-s-stock.

Display name, as the maker writes it.

What kind of part it is: stock, optic, muzzle, magazine, grip.

Who makes it.

The maker's own SKU, where they publish one.

Weight in grams.

Length in millimetres.

Magazines only

Suppressors and muzzle devices

The mount position this part occupies, or null when it takes none.

True when the part ships on the firearm from the factory. A factory part carries no statMods or specDeltas, because the firearm's own figures already include it.

The firearm this is the factory part for, when isFactoryPart is true.

Editorial adjustments to the game statistics once fitted, keyed by stat. Same status as game_* on a firearm: not measured.

Specification changes once fitted, keyed by field: a folding stock changes the folded length, for example.

Absolute URL of the manufacturer product photo on the assets CDN, ready to render. Null when no photo has been sourced yet.

Production status of an attachment. limited corresponds to a firearm's limited_production.

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 field we serve last changed.

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.

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

Category-specific facts

JSON array of the pages the figures were taken from, as a string.

Page the asset or document was taken from.

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.

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

Requirement groups. One standard from each group must be present on the firearm. Empty means universal fit.

Standards this adds to the firearm once fitted, resolved to { id, name, kind }.

Kind-prefixed standard id.

Display name, as the maker writes it.

What sort of interface it is.

What this part is rated for, where being rated matters, meaning suppressors and magazines. The caliber, bore and minimum-barrel gate is checked against these and is never bridged or inferred.

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

Display name of the cartridge.

Shortest barrel in millimetres this part is rated for in that cartridge. Null where the maker states none.

Whether the maker rates it for automatic fire in that cartridge.

Free-text notes that do not belong in a specific field.

Number of firearms with a curated override for this attachment

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

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

Attachment slug

Accepts

a lowercase slug: letters, digits and hyphens

Example

magpul-zhukov-s-stock

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

Slug of the firearm the attachment fits.

Display name, as the maker writes it.

How it fits: direct on the firearm own interface, adapter through the part named in adapter, or curated from an override on the attachment. Null when it does not fit.

The weakest evidence behind the fit.

How well evidenced this row is, 0 to 1. A minimum, not an average: an inferred row caps every fit computed through it, and min_confidence on the endpoint hides rows below a threshold.

Plain-language account of why it fits, safe to show in a UI.

The interfaces that satisfied the attachment requirements, with where each came from.

Where on the firearm the interface sits: muzzle, rear, top, bottom.

Id of the interface standard, kind-prefixed, e.g. thread:1/2x28. Ids are never renamed; new spellings become aliases.

Where an interface row on a firearm came from. curated is a person; inferred is the backfill, capped at 0.6 confidence; the inherited kinds came through the parent chain or a platform.

The adapter that bridges this fit, or null when none is needed. Threads, magazine wells and the caliber gate are never bridged.

The adapter the fit goes through, when fitType is adapter. Null for a direct or curated fit.

Who makes it.

Display name of the firearm category.

Renders and photographs of the firearm, ordered so images[0] is the frame to show at rest.

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.

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

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

Current page number

Items per page

Total matching records (Builder and above)

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

Attachment slug

Accepts

a lowercase slug: letters, digits and hyphens

Example

magpul-zhukov-s-stock

ISO 3166-1 alpha-2 code; hides sellers who do not ship there

Example

AU

The response payload.

The shop stocking the part.

Slug of the shop.

Display name, as the maker writes it.

Official website, where one is known.

Absolute URL of the logo, or null where none is on file.

The shop's own catalogue key for the listing. A seller's identifier, not ours: it is what PATCH /v1/vendor/offers/{sku} addresses.

Price in integer minor units of currency, so cents for AUD. Never a float. Format with Intl.NumberFormat at render rather than dividing first.

ISO 4217 code the price is in, e.g. AUD. Prices are integer minor units; format with Intl.NumberFormat at render rather than dividing first.

Absolute, directly fetchable URL.

Whether the shop reports it in stock. Derived from stockQty where the shop tracks a count.

Opaque token for the outbound link: send readers to /v1/out/{clickId} so the visit is counted for the seller. Null on a listing that cannot currently be followed.

ISO 3166-1 alpha-2 code the seller ships to. Null means they state no restriction.

When the seller last refreshed this listing. A listing not refreshed inside its freshness window is hidden rather than shown stale.

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

Attachment category

Max length

100

Example

stock

Manufacturer slug

Max length

100

Example

magpul

Only attachments that fit this firearm

Max length

100

Example

ak-74m

Only attachments requiring this interface standard

Max length

80

Example

rail:m-lok

Substring match on name

Max length

60

Example

pmag

Only factory parts (true) or only aftermarket (false)

Production status. The catalog keeps discontinued parts on purpose, so a store front asks for in_production

Accepts

in_productiondiscontinuedlimited

Example

in_production

Restrict to one seller. me resolves to the vendor your key belongs to

Max length

64

Example

me

Drop anything that seller does not currently stock. Needs a resolvable vendor, and yields nothing without one

One page of results

URL-safe slug identifying the part, e.g. magpul-zhukov-s-stock.

Display name, as the maker writes it.

What kind of part it is: stock, optic, muzzle, magazine, grip.

Who makes it.

The maker's own SKU, where they publish one.

Weight in grams.

Length in millimetres.

Magazines only

Suppressors and muzzle devices

The mount position this part occupies, or null when it takes none.

True when the part ships on the firearm from the factory. A factory part carries no statMods or specDeltas, because the firearm's own figures already include it.

The firearm this is the factory part for, when isFactoryPart is true.

Editorial adjustments to the game statistics once fitted, keyed by stat. Same status as game_* on a firearm: not measured.

Specification changes once fitted, keyed by field: a folding stock changes the folded length, for example.

Absolute URL of the manufacturer product photo on the assets CDN, ready to render. Null when no photo has been sourced yet.

Production status of an attachment. limited corresponds to a firearm's limited_production.

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

Standard ids this adds to the firearm once fitted. Resolved to { id, name, kind } rows on /v1/attachments/{id}.

Current page number

Items per page

Total matching records (Builder and above)