Shelf registrations: every S-3/F-3 shelf registration statement, amendment and

Shelf registrations: every S-3/F-3 shelf registration statement, amendment and automatic (WKSI) shelf, normalized into a point-in-time capacity ledger -- the upstream signal behind every dilution screener. One row per filing: ticker, cik, company name, form, shelf_type (new|amendment|automatic), capacity_amount in USD (NULL means an indeterminate/automatic shelf -- never a guessed number), securities covered, WKSI flag, is_resale (selling-stockholder registrations), EFFECT date, days_to_effective, a 3-year expiry estimate, 424B5 takedown count, and market cap / shares outstanding at filing.

Authorization is not issuance: capacity_amount is what the shelf REGISTERS, not what was sold. Screen date_gte over recent weeks for fresh shelf capacity, filter shelf_type=new + is_resale=0 rows for primary dilution risk, or pull one ticker's history. Pagination: results are capped at 50,000 rows per request; when the response has has_more=true, pass next_cursor's date and accession_number back as cursor_date and cursor_accession to fetch the next page.

Requires an Alphanume Pro API key. A 403 PRO_SUBSCRIPTION_REQUIRED or DATE_RANGE_RESTRICTED error means the key's plan does not cover the request -- it does not mean the data is missing.

get/v1/capital/shelf-registrations

Request

  • Base URL: https://api.alphanume.com
  • URL: https://api.alphanume.com/v1/capital/shelf-registrations
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

tickerstring

Ticker symbol filter, e.g. 'AAPL'. Case-insensitive.

cikstring

SEC CIK number (digits only) to filter by issuer.

formstring

Exact form type: S-3, F-3, S-3/A, F-3/A, S-3ASR or F-3ASR.

shelf_typestring

Shelf category: new, amendment, or automatic (WKSI ASR shelves).

datestring

Exact date, YYYY-MM-DD. Cannot be combined with the date range parameters.

date_gtestring

Start of date range, inclusive (YYYY-MM-DD).

date_ltestring

End of date range, inclusive (YYYY-MM-DD).

date_gtstring

Start of date range, exclusive (YYYY-MM-DD).

date_ltstring

End of date range, exclusive (YYYY-MM-DD).

updated_sincestring

Only rows whose last_updated is on/after this date (YYYY-MM-DD) -- catches EFFECT/takedown refreshes.

cursor_datestring

Pagination: the 'date' value from the previous response's next_cursor. Must be sent together with cursor_ticker.

cursor_accessionstring

Accession number from next_cursor for keyset pagination (pass with cursor_date).

Response

Matching rows.

countinteger required
dataobject[] required
has_moreboolean required
next_cursorobject nullable required

Keyset cursor: pass its fields back as the cursor_* query parameters to fetch the next page.

Changes

No recorded changes to this operation across all 1 revision of this API.