Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

SEC Filing Diff API

When companies amend their SEC filings, the changes can be buried in hundreds of pages of identical text. Datastream’s diff engine compares any two versions of a filing and returns a structured changeset — additions, deletions, and modifications — so you can see exactly what changed without reading the entire document.

Capabilities

Structured diffs

Additions, deletions, and modifications returned as structured JSON with section-level context.

Amendment comparison

Compare an original 10-K with its 10-K/A amendment automatically. Works with any form type that has amendments.

Section-level granularity

Changes grouped by section (e.g., Item 1A Risk Factors, Item 8 Financial Statements) for quick navigation.

Numeric change detection

Financial figures that changed are flagged with old and new values for instant identification of restated numbers.

Quick start

Compare an original 10-K with its amendment:
curl -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  "https://api.secapi.ai/v1/filings/diff?accession_a=0000320193-24-000081&accession_b=0000320193-25-000003"
{
  "original": "0000320193-24-000081",
  "amendment": "0000320193-25-000003",
  "form": "10-K/A",
  "changes": [
    {
      "section": "Item 8 - Financial Statements",
      "type": "modification",
      "description": "Restated revenue figure for Q3 2024",
      "old_text": "Revenue: $94,930,000,000",
      "new_text": "Revenue: $94,880,000,000"
    },
    {
      "section": "Item 1A - Risk Factors",
      "type": "addition",
      "description": "New risk factor added",
      "new_text": "Regulatory changes in the European Union may impact..."
    }
  ],
  "total_changes": 12,
  "sections_affected": 3
}

Use cases

Restatement detection

Automatically detect when companies restate financial figures by diffing 10-K and 10-K/A filings. Flag the specific numbers that changed.

Compliance monitoring

Regulatory teams can track what changed in amended filings from issuers they monitor without manually reviewing hundreds of pages.

Audit trail creation

Build an auditable record of all changes between filing versions for legal, compliance, or research purposes.

Risk factor monitoring

Track changes to Item 1A (Risk Factors) between annual filings to detect emerging risks and removed risks over time.

API endpoints

EndpointDescription
GET /v1/filings/diffCompare two filing accession numbers
GET /v1/filings/amendmentsFind all amendments for a filing

Why Datastream for filing diffs

FeatureDatastreamRaw EDGARSEC-API.ioManual review
Structured diff outputYesNoNoN/A
Section-level groupingYesNoNoManual
Numeric change detectionYesNoNoManual
REST APIYesNoNoN/A
Any form typeYesManualNoManual
PricingPay-as-you-goFree (manual)N/ALabor cost

Get started

Get your API key

Start comparing SEC filings in under 60 seconds. 250 free API calls per month.