{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/gunspec-io/json-schema/gunspec-io-manufacturer-schema.json",
  "title": "Manufacturer",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/gunspec-io-manufacturers-api-openapi.yml#/components/schemas/Manufacturer",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "URL-safe slug identifying the manufacturer, e.g. `glock`."
    },
    "name": {
      "type": "string",
      "description": "Display name, as the maker writes it."
    },
    "countryCode": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO 3166-1 alpha-2 code of where the company is based."
    },
    "foundedYear": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Year the company was founded."
    },
    "status": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "active",
        "defunct",
        "unknown",
        null
      ],
      "description": "Whether the company still trades. Much of this catalog is historical, and null means nobody has established which."
    },
    "defunctYear": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Year the company ceased trading, where that is established. Null while it still trades, and also null where the closing year is simply unknown, so an absent value is never read as \"still trading\"."
    },
    "stateOwned": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Government owned. **Null is not false**: it means nobody has established it, and a consumer treating null as false would report every unchecked company as private."
    },
    "makesFirearms": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Builds the products this catalog lists, as against importing, rebranding or customising them. Scope is the catalog rather than a legal definition: air rifles are listed here as rifles and pistols, so their makers are true. Null means unestablished."
    },
    "parentId": {
      "type": [
        "string",
        "null"
      ],
      "description": "The manufacturer that owns this one today."
    },
    "predecessorId": {
      "type": [
        "string",
        "null"
      ],
      "description": "The manufacturer this one succeeded, which is not the same as being owned by it: U.S. Repeating Arms followed Winchester without Winchester owning it."
    },
    "website": {
      "type": [
        "string",
        "null"
      ],
      "description": "Official website, where one is known."
    },
    "logoUrl": {
      "type": [
        "string",
        "null"
      ],
      "description": "Absolute URL of the logo, or null where none is on file."
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Prose summary of the record, where one has been written."
    },
    "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. 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."
    }
  }
}