How to search SEC filings

David generates SEC-style filings (10-Q, 8-K) with item sections that link back to the events that produced them. This guide shows how to find filings and read their contents.

1. Discover what’s available

# Tickers with filings
curl -s "https://api.davidhf.com/filings/tickers?scenario_id=<id>" -H "X-API-KEY: YOUR_API_KEY"

# Filing form types present
curl -s "https://api.davidhf.com/filings/types?scenario_id=<id>" -H "X-API-KEY: YOUR_API_KEY"

# Item codes present
curl -s "https://api.davidhf.com/filings/items/types?scenario_id=<id>" -H "X-API-KEY: YOUR_API_KEY"

dd.filings.tickers(scenario_id="<id>")
dd.filings.types(scenario_id="<id>")
dd.filings.item_types(scenario_id="<id>")

2. List filings

One row per accession, with the item codes it contains:

curl -s "https://api.davidhf.com/filings?scenario_id=<id>&ticker=AAPL&filing_type=10-Q" \
  -H "X-API-KEY: YOUR_API_KEY"

dd.filings.list(scenario_id="<id>", ticker="AAPL", filing_type="10-Q")

Each row carries accession_number, cik, report_period, items, source_event_ids, and the assembled text.

3. Read item-level text

To get individual item sections, for example the MD&A (Item-2), use the items endpoint:

curl -s "https://api.davidhf.com/filings/items?scenario_id=<id>&ticker=AAPL&filing_type=10-Q&item=Item-2" \
  -H "X-API-KEY: YOUR_API_KEY"

dd.filings.items(scenario_id="<id>", ticker="AAPL", filing_type="10-Q", item="Item-2")

You can also filter by year and quarter.

4. Reconcile against the data

Filing text repeats the numbers in the structured records, the same revenue and EPS that appear in /earnings and /financials. Each item also carries a source_event_id, so you can trace a disclosure to the event that triggered it via /events/timeline.

curl -s "https://api.davidhf.com/events/timeline?scenario_id=<id>&ticker=AAPL" \
  -H "X-API-KEY: YOUR_API_KEY"

dd.events.timeline(scenario_id="<id>", ticker="AAPL")

Only operating companies file. ETFs and other non-operating instruments return no issuer filings. See Ticker universe.

Get started

Core concepts

Clients

Guides

How to search SEC filings

1. Discover what’s available

2. List filings

3. Read item-level text

4. Reconcile against the data

Next

SEC filings API

News & notes

​1. Discover what’s available

​2. List filings

​3. Read item-level text

​4. Reconcile against the data

​Next

SEC filings API

News & notes

1. Discover what’s available

2. List filings

3. Read item-level text

4. Reconcile against the data

Next