{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/earningsfeed-com/json-schema/earningsfeed-com-company-profile-schema.json",
  "title": "CompanyProfile",
  "x-generated": "2026-11-06",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/earningsfeed-com-openapi.json#/components/schemas/CompanyProfile",
  "type": "object",
  "properties": {
    "cik": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "SEC Central Index Key - unique identifier for this entity"
    },
    "name": {
      "type": "string",
      "description": "Legal name of the company as registered with the SEC"
    },
    "entityType": {
      "type": [
        "string",
        "null"
      ],
      "description": "Type of SEC-registered entity:\n- **Corporation** = Public company\n- **LLC** = Limited liability company\n- **LP** = Limited partnership\n- **Trust** = Trust or fund\n- **null** = Type not specified"
    },
    "category": {
      "type": [
        "string",
        "null"
      ],
      "description": "SEC category classification based on market cap and reporting status:\n- **Large Accelerated Filer** = Market cap ≥ $700M\n- **Accelerated Filer** = Market cap $75M-$700M\n- **Non-Accelerated Filer** = Market cap < $75M\n- **Smaller Reporting Company** = Revenue < $100M or float < $250M\n- **null** = Not classified or not applicable"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Brief description of the company's business"
    },
    "tickers": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Ticker"
      },
      "description": "Stock tickers associated with this company"
    },
    "primaryTicker": {
      "type": [
        "string",
        "null"
      ],
      "description": "Primary stock ticker symbol (convenience field)"
    },
    "sicCodes": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/SicCode"
      },
      "description": "Standard Industrial Classification codes for this company"
    },
    "ein": {
      "type": [
        "string",
        "null"
      ],
      "description": "Employer Identification Number (tax ID)"
    },
    "fiscalYearEnd": {
      "type": [
        "string",
        "null"
      ],
      "description": "Fiscal year end date (MMDD format)"
    },
    "stateOfIncorporation": {
      "type": [
        "string",
        "null"
      ],
      "description": "State or country of incorporation code"
    },
    "stateOfIncorporationDescription": {
      "type": [
        "string",
        "null"
      ],
      "description": "Full state or country of incorporation name"
    },
    "phone": {
      "type": [
        "string",
        "null"
      ],
      "description": "Primary phone number"
    },
    "website": {
      "type": [
        "string",
        "null"
      ],
      "description": "Company website URL"
    },
    "investorWebsite": {
      "type": [
        "string",
        "null"
      ],
      "description": "Investor relations website URL"
    },
    "addresses": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Address"
      },
      "description": "Business and mailing addresses"
    },
    "logoUrl": {
      "type": [
        "string",
        "null"
      ],
      "description": "URL to the company's logo image"
    },
    "hasInsiderTransactions": {
      "type": "boolean",
      "description": "Whether this company has insider transaction filings"
    },
    "isInsider": {
      "type": "boolean",
      "description": "Whether this entity appears as an insider/owner in Form 3/4/5 filings"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "description": "When this company profile was last updated"
    }
  },
  "required": [
    "cik",
    "name",
    "entityType",
    "category",
    "description",
    "tickers",
    "primaryTicker",
    "sicCodes",
    "ein",
    "fiscalYearEnd",
    "stateOfIncorporation",
    "stateOfIncorporationDescription",
    "phone",
    "website",
    "investorWebsite",
    "addresses",
    "logoUrl",
    "hasInsiderTransactions",
    "isInsider",
    "updatedAt"
  ],
  "$defs": {
    "Address": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "description": "Type of address (business, mailing)"
        },
        "street1": {
          "type": [
            "string",
            "null"
          ],
          "description": "Primary street address"
        },
        "street2": {
          "type": [
            "string",
            "null"
          ],
          "description": "Secondary address line"
        },
        "city": {
          "type": [
            "string",
            "null"
          ],
          "description": "City name"
        },
        "stateOrCountry": {
          "type": [
            "string",
            "null"
          ],
          "description": "State/province code or country code"
        },
        "stateOrCountryDescription": {
          "type": [
            "string",
            "null"
          ],
          "description": "Full state or country name"
        },
        "zipCode": {
          "type": [
            "string",
            "null"
          ],
          "description": "Postal/ZIP code"
        }
      },
      "required": [
        "type",
        "street1",
        "street2",
        "city",
        "stateOrCountry",
        "stateOrCountryDescription",
        "zipCode"
      ]
    },
    "SicCode": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9999,
          "description": "4-digit SIC code (0-9999)"
        },
        "description": {
          "type": "string",
          "description": "Industry description"
        }
      },
      "required": [
        "code",
        "description"
      ]
    },
    "Ticker": {
      "type": "object",
      "properties": {
        "symbol": {
          "type": "string",
          "minLength": 1,
          "maxLength": 10,
          "description": "Stock ticker symbol"
        },
        "exchange": {
          "type": "string",
          "description": "Exchange where the ticker is listed"
        },
        "isPrimary": {
          "type": "boolean",
          "description": "Whether this is the company's primary ticker"
        }
      },
      "required": [
        "symbol",
        "exchange",
        "isPrimary"
      ]
    }
  }
}