Registrations calendar API reference

Overview

The registrations calendar lists the registration statements and final prospectuses that companies sent to the SEC, by filing day: S-1 and F-1 statements, their amendments, and the 424B4 and 424B1 prospectuses that fix the offering terms. Every request needs a Bearer key, and REST and MCP draw on one credit balance.

Each row is one filing, and most filings are not a company's first sale of shares. class says which kind each one is: ipo, spac, shell, resale or other. The S-1, its amendments and its final prospectus share one file_number, so count offerings by file_number.

Leave end out for today in UTC, and start out for 30 days before end. One request touches at most 12 calendar months, and a longer window is 400 range_too_large. History starts in November 2025.

The default is the US. country=jpn answers with Japan's securities registration statements and covers part of them: about 79% of Japan's filings have a readable body file, and the rest are missing. country=kor is a free 404 not_covered.

Base URL: https://api.narwhalapi.com. Each route below is an MCP tool of its own, with the same parameters.

Dividends, splits and earnings are on the company calendars page.

Company ids are the ones the Filings API returns from company search.

What every account gets

See pricing for what a call costs. A request is charged at the price of its API unless a route says otherwise.

• Billed at the Companies price, even though the route sits under calendars. Each successful answer is one call, whatever the number of rows, and an empty page is charged too. Errors are not charged.
• Money is in currency and as printed on the filing. A US filing leaves currency out, which means US dollars.
• ticker, the offering terms, underwriters, law_firms and management are read from the text of the filing and left out when the filing does not state them. The lists are not guaranteed complete, and an underwriter list can carry a table heading such as Joint Book-Runners as a name.
• management is read only for ipo, spac and shell filings. financials comes from the financial tags inside the prospectus. Many companies that are not yet public do not tag their statements, so it is often left out.
• cik is sent for US filings only. For another country, filter with ticker.

Endpoints

Every route is a GET and needs your key in the Authorization: Bearer header. The examples show the shape of an answer, not live data.

List registrations

GET /v1/calendars/registrations

Registration statements (S-1, F-1 and their amendments) and final prospectuses (424B4, 424B1) filed in a window of up to 12 months, oldest first. Each row is one filing, and most filings are not IPOs: class says which kind each one is.

class is ipo for a company's first public offering, whether the company, its holders or both sell. spac is a blank check company, and shell is a start-up with no operations. resale is existing holders selling shares of a company that is already public. other is a follow-on offering or anything we cannot tell apart.

price_low and price_high are the expected range on an S-1 or F-1. On a 424B4 or 424B1 they are the final price, so both are the same.

MCP: tool calendars_list_registrations.

Parameters

Response fields

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/calendars/registrations?ticker=ACCV&form=424B4&start=2026-10-01&end=2026-11-12"

{
  "start": "2026-10-01",
  "end": "2026-11-12",
  "registrations": [
    {
      "filing_id": "usa:0002141406:0001628280-26-064097",
      "cik": "0002141406",
      "company_id": "usa:0002141406",
      "name": "Accelevation Holdings Corp.",
      "form": "424B4",
      "filed": "2026-10-01",
      "class": "ipo",
      "price_low": "18.00",
      "price_high": "18.00",
      "exchange": "Nasdaq",
      "file_number": "333-298715",
      "ticker": "ACCV",
      "shares_offered": "30000000",
      "offered_as": "shares",
      "offering_amount": "540000000",
      "underwriting_discount": "28350000",
      "proceeds_before_expenses": "170550000",
      "price_per_share": "18.00",
      "underwriting_discount_per_share": "0.945",
      "proceeds_per_share": "17.055",
      "underwriters": [
        "Morgan Stanley",
        "J.P. Morgan",
        "Goldman Sachs & Co. LLC",
        "Barclays"
      ],
      "law_firms": [
        "Kirkland & Ellis LLP",
        "Simpson Thacher & Bartlett LLP"
      ],
      "management": [
        {
          "name": "Michael Rubiera",
          "title": "Chief Executive Officer and Director",
          "age": 52
        },
        {
          "name": "Kenneth Krause",
          "title": "Chief Financial Officer",
          "age": 51
        }
      ]
    }
  ],
  "next_cursor": null
}

Errors

Errors use the shared problem shape with a request_id. See Errors and credits for the shape and the credit headers. Failed requests are not charged.