All APIs

Company filings API for lists and individual records

List filings for a company, fetch a filing record or read the latest filings across companies, with links to the regulator's official copies.

First request

Quickstart →
curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/filings?type=annual" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
Example response Illustrative response · not a live request
{
  "id": "usa:0000789019",
  "filings": [
    {
      "id": "usa:0000789019:0001193125-26-323660",
      "date": "2026-07-29",
      "type": "annual",
      "title": "10-K"
    }
  ]
}

Endpoints

GETList a company's filings/v1/companies/{company_id}/filings
GETGet the latest filings across companies/v1/filings/latest
GETGet a filing record/v1/filings/{filing_id}

Find the filing you need

Company filing lists

Read a company's filings by type, form and date.

Latest filings

Get the latest filings across companies through one endpoint.

Official links

Each record includes an ID, date, type, title and link to the official filing.

Coverage

View coverage →

Coverage: US, Japan, Korea, EU/EEA, the UK and Taiwan; US history from 2009. US filings include annual forms 10-K and 20-F, quarterly form 10-Q, event forms 8-K and 6-K, and ownership Schedules 13D and 13G. Free covers the last 3 years, delivered next day; Basic covers 10 years, live; Pro covers full history, live; webhooks require Basic or Pro.

Response fields

id
Identifier for the filing
date
Date the filing was filed
type
Filing category, such as annual, quarterly, event or ownership
title
Title of the filing
url
Link to the official filing on the regulator's site
company_id
Identifier for the company associated with the filing
form
Regulator's form designation, such as 10-K or 13D
period_end
End date of the reporting period covered by the filing
filing_id (on stock earnings)
The annual, semiannual or quarterly report that covers a past earnings report. Pass it to the filing route to read the record. It is left out when no filing matches and when no report fits the date.

Explore related pages

SEC EDGAR API through Narwhal

Live US filings and standardised XBRL financials from SEC EDGAR

Explore the API →

Common questions

Which forms cover foreign private issuers?

Form 20-F is classified as annual, and Form 6-K is classified as event.

Can I retrieve a filing by its ID?

Use GET /v1/filings/{filing_id} to fetch the record for a specific filing.

Where can I read the original filing?

Follow the record's url to the official copy on the regulator's site. That document remains the source of truth.

How do I get from an earnings report to its filing?

A past earnings row on the stock routes carries a filing id when we hold the report that covers it. Pass it to the filing route. The earnings EPS and the EPS in the filing's financials can differ, because the earnings figure is on the market data basis.