Properties
| Name | Type | Description |
|---|---|---|
| id | string | URL-safe slug identifying the part, e.g. `magpul-zhukov-s-stock`. |
| name | string | Display name, as the maker writes it. |
| category | string | What kind of part it is: `stock`, `optic`, `muzzle`, `magazine`, `grip`. |
| manufacturer | object | Who makes it. |
| modelNumber | stringnull | The maker's own SKU, where they publish one. |
| weightG | numbernull | Weight in grams. |
| lengthMm | numbernull | Length in millimetres. |
| capacity | integernull | Magazines only |
| boreDiameterMm | numbernull | Suppressors and muzzle devices |
| requiresPosition | stringnull | The mount position this part occupies, or null when it takes none. |
| isFactoryPart | boolean | 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. |
| factoryFor | stringnull | The firearm this is the factory part for, when `isFactoryPart` is true. |
| statMods | object | Editorial adjustments to the game statistics once fitted, keyed by stat. Same status as `game_*` on a firearm: **not measured**. |
| specDeltas | object | Specification changes once fitted, keyed by field: a folding stock changes the folded length, for example. |
| imageUrl | stringnull | Absolute URL of the manufacturer product photo on the assets CDN, ready to render. Null when no photo has been sourced yet. |
| status | object | |
| dataConfidence | numbernull | 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 |
| updatedAt | string | When a field we serve last changed. |
| version | stringnull | 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 support |
| provenance | object | |
| description | stringnull | Prose summary of the record, where one has been written. |
| specs | object | Category-specific facts |
| sources | array | JSON array of the pages the figures were taken from, as a string. |
| sourceUrl | stringnull | Page the asset or document was taken from. |
| yearIntroduced | integernull | Year it entered production or service. Null where the date is disputed or unknown. |
| requires | array | Requirement groups. One standard from each group must be present on the firearm. Empty means universal fit. |
| provides | array | Standards this adds to the firearm once fitted, resolved to `{ id, name, kind, position }`. |
| caliberRatings | array | 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. |
| curatedFits | integer | Number of firearms with a curated override for this attachment |
| createdAt | string | When the record was first added, `YYYY-MM-DD HH:MM:SS` in UTC. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/gunspec-io/json-schema/gunspec-io-attachment-detail-schema.json",
"title": "AttachmentDetail",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/gunspec-io-compatibility-api-openapi.yml#/components/schemas/AttachmentDetail",
"allOf": [
{
"$ref": "#/$defs/AttachmentBase"
},
{
"type": "object",
"properties": {
"description": {
"type": [
"string",
"null"
],
"description": "Prose summary of the record, where one has been written."
},
"specs": {
"type": "object",
"description": "Category-specific facts"
},
"sources": {
"type": "array",
"items": {
"type": "string"
},
"description": "JSON array of the pages the figures were taken from, as a string."
},
"sourceUrl": {
"type": [
"string",
"null"
],
"description": "Page the asset or document was taken from."
},
"provenance": {
"$ref": "#/$defs/Provenance"
},
"yearIntroduced": {
"type": [
"integer",
"null"
],
"description": "Year it entered production or service. Null where the date is disputed or unknown."
},
"requires": {
"type": "array",
"description": "Requirement groups. One standard from each group must be present on the firearm. Empty means universal fit.",
"items": {
"type": "array",
"items": {
"$ref": "#/$defs/StandardRef"
}
}
},
"provides": {
"type": "array",
"items": {
"allOf": [
{
"$ref": "#/$defs/StandardRef"
},
{
"type": "object",
"properties": {
"position": {
"type": [
"string",
"null"
],
"description": "Where on the firearm the standard sits once fitted, when that is not where this part mounts: a side mount clamps to the side rail and puts its Picatinny rail over the receiver. Null means where this part mounts."
}
}
}
]
},
"description": "Standards this adds to the firearm once fitted, resolved to `{ id, name, kind, position }`."
},
"caliberRatings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"caliberId": {
"type": "string",
"description": "Slug of the cartridge. Resolve against `/v1/calibers/{id}`."
},
"caliberName": {
"type": [
"string",
"null"
],
"description": "Display name of the cartridge."
},
"minBarrelLengthMm": {
"type": [
"number",
"null"
],
"description": "Shortest barrel in millimetres this part is rated for in that cartridge. Null where the maker states none."
},
"fullAutoRated": {
"type": "boolean",
"description": "Whether the maker rates it for automatic fire in that cartridge."
},
"notes": {
"type": [
"string",
"null"
],
"description": "Free-text notes that do not belong in a specific field."
}
}
},
"description": "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."
},
"curatedFits": {
"type": "integer",
"description": "Number of firearms with a curated override for this attachment"
},
"createdAt": {
"type": "string",
"description": "When the record was first added, `YYYY-MM-DD HH:MM:SS` in UTC."
},
"updatedAt": {
"type": "string",
"description": "When a field we serve last changed."
}
}
}
],
"$defs": {
"AttachmentBase": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "URL-safe slug identifying the part, e.g. `magpul-zhukov-s-stock`."
},
"name": {
"type": "string",
"description": "Display name, as the maker writes it."
},
"category": {
"type": "string",
"description": "What kind of part it is: `stock`, `optic`, `muzzle`, `magazine`, `grip`."
},
"manufacturer": {
"anyOf": [
{
"$ref": "#/$defs/ManufacturerRef"
},
{
"type": "null"
}
],
"description": "Who makes it."
},
"modelNumber": {
"type": [
"string",
"null"
],
"description": "The maker's own SKU, where they publish one."
},
"weightG": {
"type": [
"number",
"null"
],
"description": "Weight in grams."
},
"lengthMm": {
"type": [
"number",
"null"
],
"description": "Length in millimetres."
},
"capacity": {
"type": [
"integer",
"null"
],
"description": "Magazines only"
},
"boreDiameterMm": {
"type": [
"number",
"null"
],
"description": "Suppressors and muzzle devices"
},
"requiresPosition": {
"type": [
"string",
"null"
],
"description": "The mount position this part occupies, or null when it takes none."
},
"isFactoryPart": {
"type": "boolean",
"description": "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."
},
"factoryFor": {
"type": [
"string",
"null"
],
"description": "The firearm this is the factory part for, when `isFactoryPart` is true."
},
"statMods": {
"type": "object",
"additionalProperties": {
"type": "integer"
},
"description": "Editorial adjustments to the game statistics once fitted, keyed by stat. Same status as `game_*` on a firearm: **not measured**."
},
"specDeltas": {
"type": "object",
"additionalProperties": {
"type": [
"number",
"null"
]
},
"description": "Specification changes once fitted, keyed by field: a folding stock changes the folded length, for example."
},
"imageUrl": {
"type": [
"string",
"null"
],
"description": "Absolute URL of the manufacturer product photo on the assets CDN, ready to render. Null when no photo has been sourced yet."
},
"status": {
"$ref": "#/$defs/AttachmentStatus"
},
"dataConfidence": {
"type": [
"number",
"null"
],
"description": "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."
},
"updatedAt": {
"type": "string",
"description": "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."
},
"version": {
"type": [
"string",
"null"
],
"description": "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."
},
"provenance": {
"$ref": "#/$defs/Provenance"
}
}
},
"AttachmentStatus": {
"type": "string",
"enum": [
"in_production",
"discontinued",
"limited"
],
"description": "Production status of an attachment. `limited` corresponds to a firearm's `limited_production`."
},
"ManufacturerRef": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Slug of the manufacturer."
},
"name": {
"type": "string",
"description": "Display name, as the maker writes it."
}
}
},
"Provenance": {
"type": "object",
"description": "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.",
"properties": {
"sources": {
"type": "array",
"items": {
"type": "string"
},
"description": "The pages consulted when the record was compiled, as an array. Check a specific figure against these rather than against `dataConfidence`."
},
"sourceKinds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Absolute, directly fetchable URL."
},
"kind": {
"$ref": "#/$defs/SourceKind"
},
"archivedFrom": {
"type": [
"string",
"null"
],
"description": "The original address when `url` is a Wayback Machine capture of it. A cited page that no longer answers is replaced by its last capture that answered 200, so the citation still shows what its author read; `kind` is the original page's."
},
"rank": {
"type": "integer",
"description": "The kind's place in the source hierarchy: 0 is the maker, the strongest; higher is weaker."
},
"tier": {
"type": "string",
"enum": [
"authority",
"classified",
"unclassified"
],
"description": "Where the site stands in the source registry (`/v1/data/sources`): an authority (the maker, a standards body, a government), a classified site, or one not yet classed."
},
"basis": {
"type": "string",
"enum": [
"declared",
"maker",
"rule",
"unclassified"
],
"description": "What the class rests on: classed by a person, a catalogued maker's own site, a .gov or .mil domain, or nothing yet."
},
"evidence": {
"type": [
"string",
"null"
],
"description": "The words the site was classed on, where a person recorded them."
}
},
"required": [
"url",
"kind",
"archivedFrom",
"rank",
"tier",
"basis",
"evidence"
]
},
"description": "What each cited page is, in `sources` order, on the `SourceKind` hierarchy. A host not in the source map is `other`, never guessed."
},
"bestSourceKind": {
"anyOf": [
{
"$ref": "#/$defs/SourceKind"
},
{
"type": "null"
}
],
"description": "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."
},
"makerSource": {
"type": [
"string",
"null"
],
"description": "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."
},
"evidence": {
"type": "string",
"enum": [
"verified",
"maker",
"authority",
"secondary",
"none"
],
"description": "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."
},
"checks": {
"type": "object",
"description": "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.",
"properties": {
"raised": {
"type": "integer",
"description": "Every task ever raised on the record, answered or not."
},
"open": {
"type": "integer",
"description": "Tasks still waiting to be worked."
},
"history": {
"type": "array",
"description": "The latest twenty, newest first.",
"items": {
"type": "object",
"properties": {
"task": {
"type": "string",
"description": "The task id, stable across runs; the same id `/v1/data/tasks/{taskKey}` answers for."
},
"number": {
"type": [
"integer",
"null"
],
"description": "The task's number; `/v1/data/tasks/{number}` loads it as its key does."
},
"check": {
"type": [
"string",
"null"
],
"description": "The check that raised it, where one did."
},
"kind": {
"type": "string",
"description": "`verify` reads the record against its maker's page, `gap` researches an empty field, `contradiction` judges fields that disagree, `vocabulary` a value outside a list."
},
"agent": {
"type": [
"string",
"null"
],
"description": "`redback` when the agent worked it, `staff` when a person did, null when nobody has."
},
"worker": {
"type": [
"string",
"null"
],
"description": "The agent instance that worked it; null for a person."
},
"status": {
"type": "string",
"description": "`resolved` (a proposal was filed), `unverifiable` (nothing could be established; retried after a cooldown), `not_a_fault`, or open."
},
"decidedAt": {
"type": [
"string",
"null"
],
"description": "When the task was answered; null while it is open."
},
"proposed": {
"type": [
"string",
"null"
],
"description": "What it proposed, in its own words; null while it is open."
},
"fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Per-field completeness, keyed by column name."
},
"sources": {
"type": "array",
"items": {
"type": "string"
},
"description": "The pages it read and quoted."
},
"review": {
"type": [
"object",
"null"
],
"properties": {
"decision": {
"type": "string",
"enum": [
"accepted",
"rejected"
],
"description": "Whether a person accepted the proposal."
},
"at": {
"type": [
"string",
"null"
],
"description": "When they decided."
}
},
"description": "A person's decision on the proposal; null until reviewed."
},
"finding": {
"type": [
"object",
"null"
],
"description": "What the check found, where a check raised the task: its own line for this record and the figures it measured, so a reader sees how the value breaks the method. The same the public task board serves with `include=research`.",
"properties": {
"why": {
"type": [
"string",
"null"
],
"description": "The check's line for this record."
},
"evidence": {
"type": [
"object",
"null"
],
"additionalProperties": true,
"description": "The figures the check measured."
}
},
"required": [
"why",
"evidence"
]
}
},
"required": [
"task",
"number",
"check",
"kind",
"agent",
"worker",
"status",
"decidedAt",
"proposed",
"fields",
"sources",
"review",
"finding"
]
}
}
},
"required": [
"raised",
"open",
"history"
]
},
"dataConfidence": {
"type": [
"number",
"null"
],
"description": "The 0 to 1 score set from what was actually sourced, never raised by hand. See the confidence bands in the docs."
},
"verifiedAt": {
"type": [
"string",
"null"
],
"description": "When a source was last read against this record. Null means the row is still seed knowledge."
},
"verifiedFields": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Which fields the source stated, as an array. Everything else on a verified row is still unverified. Null where no source has been read."
},
"specSource": {
"type": [
"string",
"null"
],
"description": "Cartridges only: the page the drawing figures were taken from. Null on every other kind of record."
},
"updatedAt": {
"type": "string",
"description": "When a served column last changed; the same value the record carries at the top level."
},
"version": {
"type": [
"string",
"null"
],
"description": "The record's content version, equal to the top-level `version`; equal versions mean equal data."
}
},
"required": [
"sources",
"sourceKinds",
"bestSourceKind",
"makerSource",
"evidence",
"dataConfidence",
"verifiedAt",
"verifiedFields",
"specSource",
"updatedAt",
"version"
]
},
"SourceKind": {
"type": "string",
"enum": [
"manufacturer",
"standards_body",
"government",
"peer_reviewed",
"reference",
"aggregator",
"press",
"retailer",
"community",
"other"
],
"description": "What kind of page a cited source is, strongest first: the maker's own page, a standards body (SAAMI, C.I.P.), a government or military document, an independent reference work, a specification aggregator, the press, a retailer or auction listing, a community site, or an unclassified page. Weigh a figure by the best kind behind it, never by how many pages were cited."
},
"StandardRef": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Kind-prefixed standard id."
},
"name": {
"type": "string",
"description": "Display name, as the maker writes it."
},
"kind": {
"type": "string",
"description": "What sort of interface it is."
}
}
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/gunspec-io-attachment-detail"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.