FilingsResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/filingfirehose-com/json-schema/filingfirehose-com-filings-response-schema.json",
  "title": "FilingsResponse",
  "description": "Envelope returned by /v1/filings endpoints.",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/filingfirehose-com-openapi.json#/components/schemas/FilingsResponse",
  "properties": {
    "count": {
      "type": "integer",
      "title": "Count"
    },
    "filings": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/Filing8K"
          },
          "type": "array"
        },
        {
          "items": {
            "$ref": "#/$defs/FilingS3"
          },
          "type": "array"
        },
        {
          "items": {
            "$ref": "#/$defs/Filing13"
          },
          "type": "array"
        }
      ],
      "title": "Filings"
    }
  },
  "type": "object",
  "required": [
    "count",
    "filings"
  ],
  "$defs": {
    "Filing13": {
      "properties": {
        "accession_number": {
          "type": "string",
          "title": "Accession Number"
        },
        "form_type": {
          "type": "string",
          "title": "Form Type"
        },
        "cik": {
          "type": "string",
          "title": "Cik"
        },
        "company_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Company Name"
        },
        "filed_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Filed At"
        },
        "cusip": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Cusip"
        },
        "aggregate_amount": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Aggregate Amount"
        },
        "percent_of_class": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Percent Of Class"
        },
        "activist_filers": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Activist Filers"
        },
        "purpose_excerpt": {
          "type": "string",
          "title": "Purpose Excerpt",
          "default": ""
        }
      },
      "type": "object",
      "required": [
        "accession_number",
        "form_type",
        "cik"
      ],
      "title": "Filing13",
      "description": "Parsed Schedule 13D / 13G."
    },
    "Filing8K": {
      "properties": {
        "accession_number": {
          "type": "string",
          "title": "Accession Number"
        },
        "form_type": {
          "type": "string",
          "title": "Form Type"
        },
        "cik": {
          "type": "string",
          "title": "Cik"
        },
        "company_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Company Name"
        },
        "filed_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Filed At"
        },
        "filer_reported_items": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Filer Reported Items"
        },
        "detected_items": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Detected Items"
        },
        "discrepancy_items": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Discrepancy Items",
          "description": "Items present in the body but not reported by the filer."
        },
        "suspected_buried_events": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "type": "object",
          "title": "Suspected Buried Events",
          "description": "Map of reported_item → suspected real items, based on body keywords."
        },
        "num_sections": {
          "type": "integer",
          "title": "Num Sections",
          "default": 0
        }
      },
      "type": "object",
      "required": [
        "accession_number",
        "form_type",
        "cik"
      ],
      "title": "Filing8K",
      "description": "Parsed 8-K. The wedge: `discrepancy_items` shows what the body contains\nbut the filer didn't report. That's the alpha."
    },
    "FilingS3": {
      "properties": {
        "accession_number": {
          "type": "string",
          "title": "Accession Number"
        },
        "form_type": {
          "type": "string",
          "title": "Form Type"
        },
        "cik": {
          "type": "string",
          "title": "Cik"
        },
        "company_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Company Name"
        },
        "filed_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Filed At"
        },
        "shelf_size_usd": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Shelf Size Usd"
        },
        "shelf_size_million_usd": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Shelf Size Million Usd"
        },
        "is_atm": {
          "type": "boolean",
          "title": "Is Atm",
          "default": false
        },
        "sales_agents": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Sales Agents"
        },
        "use_of_proceeds_excerpt": {
          "type": "string",
          "title": "Use Of Proceeds Excerpt",
          "default": ""
        }
      },
      "type": "object",
      "required": [
        "accession_number",
        "form_type",
        "cik"
      ],
      "title": "FilingS3",
      "description": "Parsed S-3 / 424B-family registration / takedown."
    }
  }
}