filingpulse

List normalized SEC insider ownership filings (Form 4 transactions, plus Form 3 initial statements and Form 5 annual statements — 3/5 live-forward since 2026-09-23), newest first: non-derivative and derivative transaction legs, holdings, owner roles (director/officer/10% owner), footnotes, and amendment (/A) links. Numeric values are strings exactly as filed; every object carries 'accession' and 'filed_date'. Filter by issuer ticker, issuer CIK, reporting-owner CIK (owner_cik — one insider's filings across every issuer), form_type, or since-date. Returns a {data, total, limit, offset} envelope for paging. Hosted and already normalized — no EDGAR crawling, parsing, or local install needed.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Issuer ticker symbol as filed, e.g. KMI. Case-insensitive exact match."
    },
    "cik": {
      "type": "string",
      "pattern": "^\\d{1,10}$",
      "description": "SEC CIK number, digits only (leading zeros optional)."
    },
    "owner_cik": {
      "type": "string",
      "pattern": "^\\d{1,10}$",
      "description": "Reporting owner (insider) CIK, digits only — one person or entity's filings across every issuer. Owner CIKs appear in each filing's reporting_owners[]."
    },
    "form_type": {
      "type": "string",
      "enum": [
        "3",
        "3/A",
        "4",
        "4/A",
        "5",
        "5/A"
      ],
      "description": "3 = initial ownership, 4 = transactions, 5 = annual statement; /A = amendment. Forms 3/5 are live-forward since 2026-09-23."
    },
    "since": {
      "type": "string",
      "description": "Only filings filed on/after this date (YYYY-MM-DD)."
    },
    "until": {
      "type": "string",
      "description": "Only filings filed on/before this date (YYYY-MM-DD) — with since, a fixed reproducible window."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10,
      "description": "Rows to return (max 25 on this endpoint)."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000,
      "default": 0,
      "description": "Rows to skip — page through 'total' with limit+offset."
    }
  },
  "additionalProperties": false
}

Fetch one insider ownership filing (Form 3/4/5) by SEC accession number (e.g. 0001653558-26-000110), with all transaction legs, holdings, and footnotes.

{
  "type": "object",
  "properties": {
    "accession": {
      "type": "string",
      "description": "SEC accession number, e.g. 0001653558-26-000110."
    }
  },
  "required": [
    "accession"
  ],
  "additionalProperties": false
}

List SEC 8-K corporate events classified by official item code, newest first — e.g. 2.02 results of operations, 5.02 executive/director changes, 1.01 material agreements, 7.01 Reg FD. Filter by item code, issuer ticker or CIK, or since-date. Returns a {data, total, limit, offset} envelope.

{
  "type": "object",
  "properties": {
    "item": {
      "type": "string",
      "pattern": "^\\d\\.\\d{2}$",
      "description": "Official 8-K item code, e.g. 2.02 or 5.02."
    },
    "ticker": {
      "type": "string",
      "description": "Issuer ticker symbol, e.g. KMI. 8-K headers carry no ticker, so it is resolved to a CIK via this dataset's Form 4 filings — an issuer with no Form 4 yet needs 'cik' instead."
    },
    "cik": {
      "type": "string",
      "pattern": "^\\d{1,10}$",
      "description": "SEC CIK number, digits only (leading zeros optional)."
    },
    "since": {
      "type": "string",
      "description": "Only filings filed on/after this date (YYYY-MM-DD)."
    },
    "until": {
      "type": "string",
      "description": "Only filings filed on/before this date (YYYY-MM-DD) — with since, a fixed reproducible window."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10,
      "description": "Rows to return (max 25 on this endpoint)."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000,
      "default": 0,
      "description": "Rows to skip — page through 'total' with limit+offset."
    }
  },
  "additionalProperties": false
}

List S-1/F-1 registration lifecycle events, newest first: registration statements, amendments, notices of effectiveness, and priced prospectuses (424B1/424B4), threaded across stages by SEC file number (e.g. 333-297472). Issuer objects include SIC code, state of incorporation, and former names. Coverage is live-forward since 2026-08-01. Returns a {data, total, limit, offset} envelope.

{
  "type": "object",
  "properties": {
    "stage": {
      "type": "string",
      "enum": [
        "registration",
        "amendment",
        "effectiveness",
        "prospectus"
      ],
      "description": "Lifecycle stage to filter on."
    },
    "form_type": {
      "type": "string",
      "enum": [
        "S-1",
        "S-1/A",
        "F-1",
        "F-1/A",
        "EFFECT",
        "424B1",
        "424B4"
      ]
    },
    "cik": {
      "type": "string",
      "pattern": "^\\d{1,10}$",
      "description": "SEC CIK number, digits only (leading zeros optional)."
    },
    "file_number": {
      "type": "string",
      "pattern": "^[\\d-]{1,20}$",
      "description": "SEC file number, e.g. 333-297472 — follows one offering across stages."
    },
    "since": {
      "type": "string",
      "description": "Only filings filed on/after this date (YYYY-MM-DD)."
    },
    "until": {
      "type": "string",
      "description": "Only filings filed on/before this date (YYYY-MM-DD) — with since, a fixed reproducible window."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10,
      "description": "Rows to return (max 25 on this endpoint)."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000,
      "default": 0,
      "description": "Rows to skip — page through 'total' with limit+offset."
    }
  },
  "additionalProperties": false
}

Fetch one S-1/IPO registration lifecycle event by SEC accession number.

{
  "type": "object",
  "properties": {
    "accession": {
      "type": "string",
      "description": "SEC accession number."
    }
  },
  "required": [
    "accession"
  ],
  "additionalProperties": false
}

Row counts, latest ingest timestamps, and earliest covered filing date for each dataset (Form 4, 8-K, registrations). Call this to learn what date range a query can be answered from.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

The frozen schema-v1 contract for FilingPulse objects: field-by-field documentation for form4 / event_8k / registration_event, the list envelope, design rules (strings-as-filed, null-never-missing, additive-only), and the Form 4 transaction-code table.

{
  "type": "object",
  "properties": {
    "section": {
      "type": "string",
      "enum": [
        "overview",
        "form4",
        "event_8k",
        "registration_event",
        "list_envelope",
        "transaction_codes"
      ],
      "default": "overview"
    }
  },
  "additionalProperties": false
}