Official SEC metadata
The source is the U.S. Securities and Exchange Commission. Narwhal uses company associations, submissions metadata, and EDGAR filing indexes.
Read the methodology →All APIs
SEC Filings API
Find SEC filing metadata and original document links.
First request
Quickstart →Replace YOUR_COMPANY_ID with an ID returned by company search. Company Search API →
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/YOUR_COMPANY_ID/filings?forms=10-K,10-Q&filed_from=2020-01-01&filed_to=2027-01-01&limit=50" \
--header "Authorization: Bearer $NARWHAL_API_KEY"Example response Illustrative response · not a live request
{
"company": {
"id": "cmp_a1b2c3d4e5f678901234567890abcdef",
"name": "Apple Inc.",
"cik": "0000320193"
},
"filings": [
{
"accession_number": "0000320193-24-000123",
"form": "10-K",
"filed_on": "2024-11-01",
"accepted_at": "2024-11-01T10:01:36Z",
"report_period": "2024-09-28",
"is_amendment": false,
"items": [],
"filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.html",
"primary_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"
}
],
"next_cursor": null,
"as_of": "2026-08-29T12:00:00Z"
}Endpoints
GETList company filings/v1/companies/{company_id}/filings
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.
MCP · companies_list_filings
Sources and methodology
Stable identity
One company ID stays stable when names or tickers change.
Filing metadata
Forms, dates, amendments, and SEC links stay explicit.
Coverage
View coverage →Common questions
What does the response include?
List SEC filing metadata by company, including 10-K, 10-Q, 8-K, Form 4, and 13F-HR.
What coverage is available?
The first release returns metadata and canonical SEC document links only. It does not include filing bodies, exhibits, XBRL facts, insider transactions, financial statements, or 13F holdings.
Does it include filing text or XBRL facts?
No. This contract covers company identity and filing metadata only.