{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/earningsfeed-com/json-schema/earningsfeed-com-company-search-response-schema.json",
  "title": "CompanySearchResponse",
  "x-generated": "2026-11-06",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/earningsfeed-com-openapi.json#/components/schemas/CompanySearchResponse",
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/CompanySearchResult"
      }
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ],
      "description": "Cursor for next page, null if no more pages"
    },
    "hasMore": {
      "type": "boolean",
      "description": "Whether more items exist beyond this page"
    }
  },
  "required": [
    "items",
    "nextCursor",
    "hasMore"
  ],
  "$defs": {
    "CompanySearchResult": {
      "type": "object",
      "properties": {
        "cik": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "description": "SEC Central Index Key"
        },
        "name": {
          "type": "string",
          "description": "Company name"
        },
        "ticker": {
          "type": [
            "string",
            "null"
          ],
          "description": "Primary stock ticker (if any)"
        },
        "exchange": {
          "type": [
            "string",
            "null"
          ],
          "description": "Primary exchange (if any)"
        },
        "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"
        },
        "sicCode": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Primary SIC code"
        },
        "sicDescription": {
          "type": [
            "string",
            "null"
          ],
          "description": "Primary SIC code description"
        },
        "logoUrl": {
          "type": [
            "string",
            "null"
          ],
          "description": "URL to company logo"
        }
      },
      "required": [
        "cik",
        "name",
        "ticker",
        "exchange",
        "entityType",
        "category",
        "sicCode",
        "sicDescription",
        "logoUrl"
      ]
    }
  }
}