get_dilution_instruments

Get ONE instrument family's rows with per-field SEC citations (accession number, filing date and the verbatim sentence each figure was read from). Families: warrants, convertibles, preferred, shelfs, atms, elocs, s1_offerings, equity_plans, exchangeables, recent_offerings, rights. One family per call; request only what you need.

withheldRows / withheldRowCount: rows that could NOT be verified were blanked, so every family total is a LOWER BOUND; say so. An empty rows array on a covered company is a measured "none found in the filings read"; an unavailable response is not.

disputed status (warrants / convertibles / preferred / exchangeables): the issuer's latest filing disputes the instrument; it is SHOWN and EXCLUDED from totals (summary.disputedInstrumentCount / disputedInstrumentShares); report it as a disputed claim, never as outstanding or retired.

contingencyTrigger: "event_of_default": still outstanding and COUNTED; say "converts only on an event of default", never not dilutive.

convertibles principalBasis aggregate_only / fair_value_only / conflict / undisclosed_since_issue: the current balance is NOT MEASURED (principalOutstanding null); report principalOriginal as the ORIGINAL principal.

conversionBasis: "formula_unanchored": no share count computable; unquantified, not zero. convertibles / preferred sharesIssuableBasis: "conflict_upper_bound": report "up to sharesIssuableIfConverted; the issuer states sharesIssuableIssuerStated", never the higher figure alone as the issuer's count.

warrants with null sharesUnderlying beside aggregateExerciseValueDollars / exercisePriceFloor / sharesCeilingAsFiled are dollar-denominated or capped: summary.warrantSharesCeiling is a ceiling, never a count and never in potentialNewShares. warrantCount counts WARRANTS, not shares.

shelfs babyShelfCurrentCapacityDollars is a STORED, DATED figure, NOT TODAY'S HEADROOM: always report it with babyShelfCapacityAsOf (null = undated, never current; babyShelfCapacityBasis names its float). For the raisable-now figure call get_baby_shelf_capacity; never present the stored figure as current.

rights (SPAC unit rights): rightsCount counts RIGHTS, not shares; sharesPerRight is the printed fraction of a share per right; sharesUnderlying is the share count (null = unsized, never 0), delivered on the initial business combination and lapsing if none closes. A snapshot stored before this family returns examined: false for rights: not analysed, never "no rights".

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