Skip to main content
Compare two SEC filings for the same company across fiscal periods and report what changed, section by section. Returns a compact per-section manifest — changed, unchanged, or unavailable, with line counts and a prose churn percentage for changed sections — alongside a rendered Markdown report. Summary mode returns the manifest only; diff mode adds the changed hunks. Endpoint: POST /api/v1/sec/diff Tier: point · Delivery: sync

​
Request

FieldType
tickerstring
baseobject\{year: number; period: "FY" | "Q1" | "Q2" | "Q3" | "Q4"}
compareobject\{year: number; period: "FY" | "Q1" | "Q2" | "Q3" | "Q4"}
sectionsstring
mode"diff" | "raw" | "summary"
qaboolean

​
Response

The response is the two-key envelope { finterm, data }, where data is the finterm.result:SecFilingDiff/v1 contract:
FieldDescription
tickerThe stock ticker symbol, uppercased (e.g. “AAPL”).
baseThe baseline (earlier) filing reference: fiscal year and period, plus the resolved form type, filing date, and period-end date when available.
compareThe comparison (later) filing reference: fiscal year and period, plus the resolved form type, filing date, and period-end date when available.
modeThe output mode: “diff” (changed hunks), “summary” (manifest only), or “raw” (both section texts in the report).
manifestPer-section change summary. Each row gives the section name, its status, and — for changed sections — the added/removed line counts and the prose churn percentage.
reportThe rendered comparison report in Markdown, or null when the report was delivered out of band.

​
Example

finterm tool sec_filing_diff AAPL --base 2023:FY --compare 2024:FY --sections risk_factors --mode summary