get_dilution_history

Get the historical shares-outstanding and cash series from SEC XBRL filings, with offering and material-cash-event overlays so an issuance or a raise can be lined up against the share count and cash balance around it. Use for share count growth over time and for the cash trajectory between financings.

THE HISTORICAL SHARE COUNTS ARE AS FILED — each point is on the split basis in force when it was reported and is NOT rebased to today, so a reverse split shows as a step and points either side of one are not directly comparable. Do not compute a growth rate across a split boundary from these raw points. A gap in the series means no filing supplied that period, not that the share count was unchanged.

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. Figures are as of meta.asOfDate, from filings read through meta.filingsThrough (a stale date predates anything filed since). Share counts are on one split basis; a row that cannot be rebased is omitted and counted, never published on a mixed basis.

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).