SEC filings API reference

Company search, stable identity, and filing metadata. API access is not open yet

Base URL and identity

REST base path

https://api.narwhalapi.com/v1/companies

Search accepts company name, ticker, or zero-padded ten-digit CIK.
Every returned company has one stable opaque company_id. Ticker and CIK remain aliases.
REST and MCP use the same input and output schemas.

Request

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

Three first-release operations

Each operation has one REST path and one MCP tool with the same input and output schema.

Operation	REST path	MCP tool
Search companies	`/v1/companies`	`companies_search`
Get company identity	`/v1/companies/{company_id}`	`companies_get`
List company filings	`/v1/companies/{company_id}/filings`	`companies_list_filings`

Shared behavior

Collection results use deterministic ordering and opaque cursors instead of offsets or page numbers.
Cursors are bound to the normalized query, company ID, limit, and every filing filter.
Search and filing pages carry one UTC as_of time for the complete publication snapshot.
An unknown company ID returns 404 company_not_found. A known company with no matching filings returns an empty array.
Invalid form, date, cursor, or pagination input returns 400 invalid_query.
Successful REST and MCP responses use the shared Narwhal quota.

First-release scope

The first release is metadata and canonical SEC links only. It does not include filing bodies, exhibits, XBRL facts, full-text search, CUSIP data, financial statements, normalized insider transactions, institutional holdings, alerts, or trading signals.

Public coverage and freshness are not published yet. Read the Companies methodology for identity, amendment, and snapshot rules.