get_dilution_coverage

Cheap pre-check for whether Signal8 holds a dilution analysis for a company: coverage status (verified / stale / not_covered), extraction state (never_extracted / running / failed / timeout / complete), last attempt and last success timestamps, the coverage tier, and whether the ticker is out of scope. CALL THIS FIRST before the expensive dilution tools.

An outOfScope ticker is a statement about the PRODUCT (dilution analysis covers small-cap issuers only) and says NOTHING about that company's dilution.

stale means the analysis is real but predates recent filings; statusDetail refines it: newer_filing_unread (unreadFilings names the material filings since: new/amended instrument, 424B5 pricing, split, 10-K) or delisting_filed (delistingFiled names the Form 25/25-NSE/15). Say the analysis predates that filing, never present it as current.

A null unreadFilings is NOT MEASURED, never "nothing filed since". ALWAYS RETURNS 200: read available and reason, never the HTTP status. not_covered means this company has not been analysed yet, not that it has no dilution; an outage is a 5xx. NULL, absent or withheld means NOT MEASURED; it never means "no dilution", "no warrants", "no shelf" or zero.

A numeric 0 is a MEASURED zero and defeats a null check: decide from the availability/withheld/reason field, never from the value itself. Included in Signal8 Pro: without it the call returns 403 FEATURE_NOT_AVAILABLE with requiredTier: "pro" (a tier upgrade; there is no add-on to buy).