Skip to content

TOOL REFERENCE

get_filing_extract

Grounded facts extracted from a filing. This is a read-only research or operational tool. It does not place trades or issue investment recommendations.

get_filing_extract

Grounded facts extracted from a filing

USE WHEN

Read source-grounded facts from a selected filing after finding it in the company events feed.

PARAMETERS

get_filing_extract parameters
NameTypeRequiredDefaultDescription
querystringYesCompany name, symbol, code or ISIN.
news_idstringYesFiling/news identifier returned by get_stock_events.

RESPONSE DATA

  • Extracted facts with source quotes, page references, filing metadata and guard status.
  • On a cache miss: status ("pending"/"failed"/"not_queued"), queued flag, and attachment_url so the raw filing is still reachable.

NOTES

  • Call get_stock_events first to find a news_id.
  • A cache miss usually enqueues on-demand extraction (status "pending", retry in ~1–2 min) rather than failing outright.
  • reason_code on a non-pending miss: "not_queued" (with sub-reasons "results_available_via_financials" or "no_document_to_extract") or "failed" (with error_reason), plus "on_demand_quota_exceeded" if the caller is rate-limited.

EXAMPLE PROMPTS

  • Extract the reported facts from this company's latest investor presentation filing.
Also available via REST: /stocks/{q}/filings/{news_id}/extract

KEEP EXPLORING

Connect your AI to Indian stock market data

Sign in to DalalOS and connect your AI in one line of config. Free to start.