A ticker search also returns rows this issuer FILED UNDER SYMBOLS IT NO LONGER LISTS (renames, filer typos, ADR spellings)

A ticker search also returns rows this issuer FILED UNDER SYMBOLS IT NO LONGER LISTS (renames, filer typos, ADR spellings). Each row keeps ticker as SEC received it and gains current_ticker when the issuer trades under a different symbol today. Separately-listed share classes are NOT merged, and asking for a RETIRED symbol returns only rows filed under it — retired symbols get reissued to other companies. Returns FILING-LEVEL records from SEC Form 3/4/5 filings — one row per filing (accession). Use this when the user asks: list an issuer's insider filings, find a specific accession, filter by form type (Form 4 trades vs Form 3 initial statements vs Form 5 annual vs their /A amendments), count filings over a period, or size a filing (how many transaction / holding rows it has) before pulling detail. This is the filing INDEX. For the actual trades use get_insider_transactions; for the positions use get_insider_holdings. They join on accession_number. Source: SEC bulk Form 3/4/5 dataset (insider_filings_v2), 2006→present, refreshed quarterly. Each row carries the SUBMISSION envelope (company_cik, company_name, ticker, document_type, filing_date, period_of_report, is_amendment), ALL reporting owners (reporting_owners[]), signature rows, and per-table counts (nonderiv_trans_count, deriv_trans_count, nonderiv_holding_count, deriv_holding_count, footnote_count). Useful filter combos: ticker='AAPL', document_type='4' all Apple Form 4 filings company_cik='0000320193', is_amendment=true Apple's amended filings only accession_number='0000320193-26-000078' one specific filing's envelope ticker='TSLA', since='2025-01-01' TSLA insider filings this year ticker='NVDA', reporting_owner_name='Huang' NVDA filings involving Huang document_type values are the raw SEC form codes: '3', '4', '5' and their amendments '3/A', '4/A', '5/A'.

get/v1/insider-filings

Request

  • Base URL: https://api.keyvex.com
  • URL: https://api.keyvex.com/v1/insider-filings
  • Auth: API key in header x-api-key

Query parameters

accession_numberstring

Exact EDGAR accession number — returns that one filing's envelope directly.

tickerstring

Exact issuer ticker (e.g., 'AAPL', 'BRK.B').

company_cikstring

Issuer CIK (10-digit, leading-zero padded). All of that company's insider filings.

company_namestring

Case-insensitive substring against issuer company name (e.g., 'Apple', 'Tesla').

document_typestring

Exact SEC form code: '3' (initial), '4' (changes), '5' (annual), or amendments '3/A' / '4/A' / '5/A'.

is_amendmentboolean

True returns only amendments (/A forms); false returns only originals. Omit for both.

reporting_owner_namestring

Case-insensitive substring matched against ANY reporting owner on the filing (scans reporting_owners[]). Best combined with ticker/company_cik.

sincestring

ISO date (YYYY-MM-DD). Only filings with filing_date >= this date.

untilstring

ISO date (YYYY-MM-DD). Only filings with filing_date <= this date.

sort_by'filing_date'

Sort field. Only filing_date is supported. Default: filing_date.

sort_order'desc' | 'asc'

Default: desc (most recent filings first).

limitinteger

Maximum records to return. Default 50, max 500.

Response

JSON envelope: { results: [...], count, has_more }.

Changes

No recorded changes to this operation across all 1 revision of this API.