Query financial observations

Canonical observation endpoint. Returns one or more (company, metric, period) tuples in the requested layout (long, wide, grouped) with optional provenance and quality metadata. Numeric values are returned as decimal strings — see "Numeric precision" in the docs. The result is bounded by tickers × metrics × period (no cursor pagination); GET caps resolved tickers at 100, POST lifts that to 1000 for batch use cases.

asReported=true caveat: facts_canonical has no fiscal_year column, so period=FY{YYYY} on the asReported path matches by CALENDAR year of period_end. For issuers whose fiscal year ends in January (e.g., Walmart FY2024 ends 2024-01-31) the calendar-year approximation will miss the row. Use the default path (asReported=false) for accurate fiscal-period selection on those issuers.

asof:{YYYY-MM-DD} returns a snapshot: one row per (company, metric) at the most recent period_end on or before the date. On the asReported path the date filters filings.filing_date (point-in-time view).