gunspec-io · Schema

AttachmentDetail

FirearmsDatabaseSpecificationSDKMCP

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.
View JSON Schema on GitHub

JSON Schema

gunspec-io-attachment-detail-schema.json Raw ↑
{
  "$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.
All 92 tools →

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.