Skip to main content
David generates SEC-style filings (10-Q, 8-K) with accession numbers, CIKs, report periods, and item sections. Filings are grouped by accession and link back to the events that produced them via source_event_id. Only operating companies file; ETFs and other non-operating instruments return no issuer filings.

​
Filings

GET /filings
One row per synthetic filing/accession, with the item codes it contains and the assembled body text.
ParameterTypeRequiredDefaultDescription
scenario_idstringYes-The world to read from.
tickerstringNoallRestrict to one ticker.
filing_typestringNoallFilter by form, e.g. 10-Q, 8-K.
start_date / end_datedateNo-Filing-date window.
limitintegerNo10Page size (max 100).
offsetintegerNo0Pagination offset.
curl -s "https://api.davidhf.com/filings?scenario_id=<id>&ticker=AAPL&filing_type=10-Q" \
  -H "X-API-KEY: YOUR_API_KEY"

{
  "filings": [
    {
      "filing_id": "AAPL:10-Q:0000320193-26-000018",
      "ticker": "AAPL",
      "cik": "0000320193",
      "filing_type": "10-Q",
      "accession_number": "0000320193-26-000018",
      "filing_date": "2026-04-24",
      "report_period": "2026-03-31",
      "url": "https://.../",
      "title": "AAPL Form 10-Q for period ended 2026-03-31",
      "description": "Form 10-Q synthetic SEC-style filing ...",
      "items": ["Item-2", "Item-2.02"],
      "item_count": 2,
      "sections": [ { "item": "Item-2", "item_name": "MD&A", "text": "..." } ],
      "source_event_ids": ["evt_..."],
      "text": "AAPL Form 10-Q ...\n\nItem-2: MD&A\n..."
    }
  ]
}

​
Filing items

GET /filings/items
Item-level text, one row per item section, for agent reading and reconciliation against the structured records.
ParameterTypeRequiredDefaultDescription
scenario_idstringYes-The world to read from.
tickerstringNoallRestrict to one ticker.
filing_typestringNoallFilter by form.
itemstringNoallFilter by item code, e.g. Item-2.
yearintegerNoallFilter by filing year.
quarterintegerNoallFilter by quarter (1–4).
start_date / end_datedateNo-Filing-date window.
limitintegerNo20Page size (max 100).
offsetintegerNo0Pagination offset.
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"

{
  "filing_items": [
    {
      "artifact_id": "filing_item_...",
      "ticker": "AAPL",
      "cik": "0000320193",
      "filing_type": "10-Q",
      "item": "Item-2",
      "item_name": "MD&A",
      "filing_date": "2026-04-24",
      "report_period": "2026-03-31",
      "text": "Management's discussion ...",
      "accession_number": "0000320193-26-000018",
      "source_event_id": "evt_...",
      "validation": { "...": "..." }
    }
  ]
}

​
Discovery helpers

GET /filings/tickers
GET /filings/ciks
GET /filings/types
GET /filings/items/types
EndpointReturns
/filings/tickersTickers with filings.
/filings/ciksCIKs with filings (falls back to company CIKs).
/filings/typesDistinct filing form types (e.g. ["10-Q", "8-K"]).
/filings/items/typesDistinct item codes (e.g. ["Item-2", "Item-2.02"]).
Each takes only scenario_id. 
curl -s "https://api.davidhf.com/filings/types?scenario_id=<id>" \
  -H "X-API-KEY: YOUR_API_KEY"

{ "filing_types": ["10-Q", "8-K"] }