SEC Filing Diff

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

Field	Type
`ticker`	`string`
`base`	`object\{year: number; period: "FY" \| "Q1" \| "Q2" \| "Q3" \| "Q4"}`
`compare`	`object\{year: number; period: "FY" \| "Q1" \| "Q2" \| "Q3" \| "Q4"}`
`sections`	`string`
`mode`	`"diff" \| "raw" \| "summary"`
`qa`	`boolean`

Response

The response is the two-key envelope { finterm, data }, where data is the finterm.result:SecFilingDiff/v1 contract:

Field	Description
`ticker`	The stock ticker symbol, uppercased (e.g. “AAPL”).
`base`	The baseline (earlier) filing reference: fiscal year and period, plus the resolved form type, filing date, and period-end date when available.
`compare`	The comparison (later) filing reference: fiscal year and period, plus the resolved form type, filing date, and period-end date when available.
`mode`	The output mode: “diff” (changed hunks), “summary” (manifest only), or “raw” (both section texts in the report).
`manifest`	Per-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.
`report`	The 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

Getting Started

CLIs

Point Tools

Bundle Tools

SEC Filing Diff

Request

Response

Example

​Request

​Response

​Example

Request

Response

Example