SIC Industry Code Lookup (by Company Domain or Name)

{
  "type": "object",
  "required": [
    "input"
  ],
  "properties": {
    "type": {
      "enum": [
        "original_sic",
        "latest_sec"
      ],
      "type": "string",
      "description": "Which SIC dataset to classify against: 'original_sic' (the 1987 Standard Industrial Classification, default) or 'latest_sec' (the current list published by the SEC)."
    },
    "input": {
      "type": "string",
      "minLength": 4,
      "description": "Brand domain (preferred, e.g. 'example.com') or company title. A valid domain is classified directly; otherwise the upstream searches for the brand by title first."
    },
    "timeoutMS": {
      "type": "integer",
      "maximum": 300000,
      "minimum": 1000,
      "description": "Upstream timeout in milliseconds (max 300000). The upstream call is aborted with a 408 when exceeded. Keep it below the endpoint's requestTimeoutMs so the provider answers before the platform's own budget expires."
    },
    "maxResults": {
      "type": "integer",
      "default": 5,
      "maximum": 10,
      "minimum": 1,
      "description": "Maximum number of codes to return (1-10). Default 5."
    },
    "minResults": {
      "type": "integer",
      "default": 1,
      "maximum": 10,
      "minimum": 1,
      "description": "Minimum number of codes to return (1-10). Default 1."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "'sic' on both real fixtures observed."
    },
    "codes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "The SIC code, e.g. '7372', '5600'."
          },
          "name": {
            "type": "string",
            "description": "The SIC code's own title, e.g. 'PREPACKAGED SOFTWARE' -- an industry-category label, not a person's or company's identifying name."
          },
          "office": {
            "type": "string",
            "description": "Only observed against the SEC's current SIC list (nike.com fixture): the SEC office that owns this code, e.g. 'Office of Trade & Services'. Absent when classifying against the 1987 original list."
          },
          "confidence": {
            "type": "string",
            "description": "e.g. 'high', 'medium' -- observed values on the two real fixtures."
          },
          "majorGroup": {
            "type": "string",
            "description": "Only observed against the 1987 original SIC list (apple.com fixture): the 2-digit major-group code, e.g. '73'. Absent when classifying against the SEC's current list."
          },
          "majorGroupName": {
            "type": "string",
            "description": "Only observed against the 1987 original SIC list (apple.com fixture): the major group's own title, e.g. 'BUSINESS SERVICES' -- an industry-category label, not a person's or company's identifying name. Absent when classifying against the SEC's current list."
          }
        },
        "additionalProperties": false
      },
      "description": "The matched SIC code(s), most-confident first on both fixtures observed."
    },
    "domain": {
      "type": "string",
      "description": "The domain that was classified, echoing (or resolved from) the input."
    },
    "status": {
      "type": "string",
      "description": "'ok' on both real fixtures observed (apple.com, nike.com)."
    },
    "classification": {
      "type": "string",
      "description": "Which SIC list was used: 'original_sic' (the 1987 list, the default) or 'latest_sec' (the SEC's current list), matching the request's own `type` input."
    }
  },
  "description": "The classification record, as returned at the factory's default $.output path.",
  "additionalProperties": false
}