get_reverse_splits_list

Get the cross-company reverse-split lists the Signal8 Reverse Splits page serves: ONE view per call. view "upcoming" = splits with an effective date from tomorrow through 30 US market days ahead, the vendor market calendar UNION Signal8's SEC-filing tracker (filings, exchange and depositary notices); "recent" = the same union for effective dates in the past 30 days; "approved_no_date" = tracked episodes where shareholders (or the board, where no vote is required) have APPROVED a reverse split but no effective date is stated yet; "vote_pending" = tracked episodes where a reverse split is PROPOSED and the shareholder vote has NOT happened yet.

A security sits on exactly one view (upcoming, then recent, then approved_no_date, then vote_pending).

Each row carries ticker, companyName, hasPage, source ("market_calendar" or "tracker"), stage + stageLabel, trackerState, ratio (or ratioMin / ratioMax for an authorised range), meetingDate, approvedDate, effectiveDate, effectiveDateSource, marketCalendarAgrees / marketCalendarDate / marketCalendarRatio, effectiveCondition, verification, marketConfirmation (recent only), marketCapUsd + capBucket, securityType, exchange, cik, sourceUrl / sourceAccession / sourceFormType / sourceFiledDate / sourceLabel, sourceDocuments (every document behind the episode), quote, adsRatioChange, approvalPath, domicile, splitAuthority and authorityTerms.

NULL MEANS NOT MEASURED OR NOT STATED, NEVER "NO SPLIT", never zero, never "no vote needed", never "no date". A null ratio = the documents state none yet; a null marketCapUsd = cap not measured (capBucket is then null, never "nano"); a null verification = no tracked episode; a null domicile = not measured (never "Delaware"); a null marketConfirmation = the price step was not measured.

An EMPTY rows array on a view is normal and is not evidence that no company is splitting. completeness says what the view is: "scheduled_as_of_now" (upcoming) and "recorded_as_of_now" (recent) are what is KNOWN as of now, never "all reverse splits"; "tracked_episodes" is what the tracker has read from filings since it started, never every company.

A scheduled split can still be postponed or cancelled: say "scheduled", never "confirmed" or "will".

DATES. effectiveDate is the SCHEDULED effective date (vendor calendar, or the issuer-stated date strictly parsed from the filing); a filing or listing-rule DEADLINE is never an effective date and never appears in this field.

A conditional date ("the 25th trading day after...") is returned VERBATIM in effectiveCondition and is never a date: do not compute one. effectiveDateSource says where effectiveDate came from: "filing" = the issuer stated it; "market_calendar" = the filing states no date and the vendor calendar supplies it. marketCalendarAgrees is a CROSS-CHECK on a tracker row the calendar also lists: true = same date and ratio; false = at least one differs and marketCalendarDate / marketCalendarRatio hold the calendar's value (the filing wins; report the disagreement, do not pick one); null or absent = not compared (no calendar row). meetingDate is the shareholder meeting date, not the split date.

APPROVAL AND AUTHORITY. approvalPath.path is shareholder_vote, written_consent, fpi_written_resolution, pre_approved_range (the board sets the ratio inside a range shareholders approved earlier), board_only (the issuer's OWN filing says no shareholder approval is required, quoted) or unknown ("Not determined", not "no vote"). splitAuthority.boardMayActWithoutVote is true ONLY from the issuer's own filing or charter; a domicile default alone is not a finding. authorityTerms is the authority behind the episode: a cumulativeCap (the board may split in STEPS, each within the cap, without a new vote until the authority expires), multiStep, the expiry, and what executed splits already used. null = the documents state nothing beyond the ratio.

LOCKED ROWS ARE WITHHELD, NOT ABSENT. The split facts on every view are Signal8 Pro. A caller whose API key is not owned by a Pro account gets EVERY row with locked: true and ONLY ticker, companyName, hasPage and exchange on it; the response then says access: "preview", lockedCount = how many rows are locked, and rowLimit.

A locked row means the facts exist and were not shown to this caller: never read it as "no split", never guess the missing fields from another source, and tell the user the facts need Signal8 Pro. access: "full" = every row carries its facts. filtersLimitedToUnlocked: true = a board / domicile filter was applied to unlocked rows only (locked rows are left out entirely, because matching them would reveal the fact through membership).

FILTERS apply server-side: cap (scanner buckets), type (security type), exchange, board ("without_vote": board split authority on file, from the issuer's own filing or charter) and domicile.

Each accepts "not_measured" to select rows where that fact was not measured; an unmeasured row never matches a measured bucket. totalCount is the filtered list (locked rows included), unfilteredCount the view before filters, capUnknownCount the rows whose cap was not measured (on the calendar views).

Page with limit / offset; truncated: true = more rows exist. available: false with reason "tracker_not_enabled" (the two tracker views) means the tracker is switched off: say it is unavailable, not that nothing is pending. An HTTP 503 FEATURE_DISABLED means the page is switched off: report that it is unavailable and say nothing about any company's split.

Describe what is on file; give no view on whether a split will happen, what it means for the price, or what anyone should do.