All APIs

SEC filing API

Search companies and find SEC filing metadata by name, ticker, or CIK

First request

Find a covered SEC issuer by company name, ticker, or ten-digit CIK.

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies?query=AAPL&limit=20" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

Example response Illustrative response · not a live request

{
  "query": "AAPL",
  "companies": [
    {
      "id": "cmp_a1b2c3d4e5f678901234567890abcdef",
      "name": "Apple Inc.",
      "cik": "0000320193",
      "listings": [
        {
          "ticker": "AAPL",
          "exchange": "Nasdaq"
        }
      ]
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T12:00:00Z"
}

Endpoints

GETSearch companies/v1/companies

Find a covered SEC issuer by company name, ticker, or ten-digit CIK.

query: Company name, ticker, or ten-digit CIK. Name and ticker matching is case-insensitive.
limit: Maximum companies to return. Defaults to 20.
cursor: Continuation token from the previous page. It is bound to the original query and filters.

MCP · companies_search

Company Search API →API reference →

GETGet company identity/v1/companies/{company_id}

Resolve one stable Narwhal company ID to its SEC identity, listings, industry code, and former names.

company_id: Stable company identity returned by company search. Ticker and CIK remain aliases, not permanent route identity.

MCP · companies_get

Company Identity API →API reference →

GETList company filings/v1/companies/{company_id}/filings

List SEC filing metadata by company, including 10-K, 10-Q, 8-K, Form 4, and 13F-HR.

company_id: Stable company identity returned by company search. Ticker and CIK remain aliases, not permanent route identity.
forms: Exact case-sensitive form tokens. A base form also matches its /A amendment unless amendments are excluded.
filed_from: Inclusive filing-date lower bound.
filed_to: Exclusive filing-date upper bound. It must be later than filed_from.
include_amendments: Include amendments when a base form is requested. Defaults to true.
limit: Maximum filings to return. Defaults to 50.
cursor: Continuation token from the previous page. It is bound to the original query and filters.