SEC EDGAR Filing Search (by Company, Ticker, CIK, or Keyword)

{
  "type": "object",
  "anyOf": [
    {
      "required": [
        "q"
      ]
    },
    {
      "required": [
        "company"
      ]
    },
    {
      "required": [
        "cik"
      ]
    }
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "full-text query"
    },
    "cik": {
      "type": "string",
      "description": "SEC CIK"
    },
    "type": {
      "type": "string",
      "description": "form type, e.g. 10-K|10-Q|8-K"
    },
    "company": {
      "type": "string",
      "description": "entity name"
    },
    "maxItems": {
      "type": "string",
      "default": "20"
    },
    "dateRange": {
      "type": "string",
      "description": "YYYY-MM-DD..YYYY-MM-DD"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of matching filing/exhibit records returned in `items`."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ciks": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The filer's SEC Central Index Key(s), zero-padded."
          },
          "form": {
            "type": "string",
            "description": "SEC form type of the filing, e.g. '10-K'."
          },
          "type": {
            "type": "string",
            "description": "The record's own type discriminator, observed as 'sec_filing' on every real record."
          },
          "score": {
            "type": "number",
            "description": "The search engine's own relevance score for this match."
          },
          "ticker": {
            "type": [
              "string",
              "null"
            ],
            "description": "The filer's stock ticker. Observed null for several real records -- not every SEC filer has a public ticker."
          },
          "company": {
            "type": "string",
            "description": "The filer's company name as recorded in SEC EDGAR."
          },
          "exhibit": {
            "type": [
              "string",
              "null"
            ],
            "description": "Exhibit identifier within the filing, e.g. 'EX-21.1'. Observed null on at least one real record (a filing matched without a specific exhibit id)."
          },
          "filedAt": {
            "type": "string",
            "description": "Date the filing was submitted to the SEC, YYYY-MM-DD."
          },
          "accessionNo": {
            "type": "string",
            "description": "The filing's SEC accession number."
          },
          "periodOfReport": {
            "type": "string",
            "description": "The reporting period the filing covers, YYYY-MM-DD."
          }
        },
        "additionalProperties": true
      },
      "description": "Matching filing/exhibit records, most relevant first (see `score`)."
    }
  },
  "description": "The search result, as returned at routing.responseResultPath ($.output). A query that matches nothing shapes to `{count: 0, items: []}` (see examples/empty-nonsense-query.json) -- no field below is guaranteed populated.",
  "additionalProperties": true
}