---
title: "Shelf registrations: every S-3/F-3 shelf registration statement, amendment and"
method: GET
path: "/v1/capital/shelf-registrations"
---

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

`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

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.

## Query parameters

- `ticker` string
- `cik` string
- `form` string
- `shelf_type` string
- `date` string
- `date_gte` string
- `date_lte` string
- `date_gt` string
- `date_lt` string
- `updated_since` string
- `cursor_date` string
- `cursor_accession` string

## Response `200`

Matching rows.

- PaginatedEnvelope
  - `count` integer, required
  - `data` object[], required
  - `has_more` boolean, required
  - `next_cursor` object, nullable, required: Keyset cursor: pass its fields back as the cursor_* query parameters to fetch the next page.

## Other responses

- `400`: Invalid or conflicting query parameters.
- `401`: Missing or unrecognized API key.
- `403`: PRO_SUBSCRIPTION_REQUIRED: the key's plan does not include API access; every endpoint requires an active Pro subscription. DATE_RANGE_RESTRICTED: a legacy free-tier key asked for dates outside its window. In both cases the data is not missing.
- `429`: Rate limit exceeded (600/min); the body carries retry_after_seconds.

---

[API](https://skmtc.dev/alphanume/apis/alphanume-api.md) · [All operations](https://skmtc.dev/alphanume/apis/alphanume-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alphanume/apis/alphanume-api/revisions/2cb83f10bba4?raw)