Skip to main content
US FR / API · United States

Build on United States filings programmatically.

A typed REST API over 4,969,258 filings from 5,441 American listed companies — JSON metadata, Markdown body, and original PDF. Webhooks on every new release.

Public-company filings in United States are supervised by Securities and Exchange Commission (SEC). Reporting follows US GAAP (IFRS permitted for foreign private issuers). Filings are most commonly published in English. Major issuers are listed on S&P 500, Dow Jones Industrial Average and Nasdaq 100. Calendar year predominant; non-calendar fiscal years common.

Building on US filings programmatically — FinancialReports vs the EDGAR API

The FinancialReports API delivers SEC-supervised US filings through the same single REST surface, one x-api-key header, and one shared rate-limit bucket used across all covered markets. A US-only integration is a one-parameter filter (?country=US) on the global filings endpoint — 10-K, 10-Q, 8-K, DEF 14A, Form 4, Form 13F, 20-F, and 6-K are all served through the same endpoint with a consistent JSON envelope that is structurally identical to the payload for a German BaFin ad-hoc or a French AMF filing. No separate API key, no US-specific infrastructure, and no US-only rate-limit bucket is needed.

The distinction between the FinancialReports API and the SEC's own EDGAR API (data.sec.gov) is worth stating precisely. EDGAR's API is US-only, form-driven, and requires consumers to navigate CIK identifiers, form-type codes, and filing-index structures; it exposes the raw EDGAR data model directly, without normalisation. FinancialReports provides a normalised, cross-border layer: the same API call that retrieves a US 10-K also retrieves a German annual report or a Brazilian DFP, with consistent field names, consistent filing-type taxonomy, and consistent body-format options — which is the critical advantage for any research or application that spans multiple markets simultaneously. For US-only, EDGAR-native workflows, the EDGAR API is free and comprehensive; for cross-border workflows that include the US alongside European or EM markets, the FinancialReports API eliminates the per-market integration cost.

For real-time pipelines the webhook subscription delivers full filing metadata within roughly 60 seconds of EDGAR acceptance — covering the full set of form types, not just periodic reports. Filing bodies are available as JSON metadata (issuer, form type, period, CIK, ISIN, exchange, filer category), Markdown via /api/filings/{id}/markdown/ (the same processed text rendered on the public web pages, ready for LLM and NLP ingestion without a separate EDGAR-to-text conversion step), and original PDF or Inline XBRL for audit and structured-data use cases. Inline XBRL is preserved from EDGAR for 10-K and 10-Q financial statements, retaining machine-readable line-items where the SEC mandates them.

Typical US API use cases include backfilling S&P 500 and Russell 1000 consolidated US GAAP financials for quant research, triggering on 8-K current reports for earnings releases and M&A announcements, monitoring Form 4 insider transactions across a target coverage universe, ingesting DEF 14A proxy text for governance-factor models, tracking 13F institutional-holdings changes for flow-of-funds analysis, and building cross-border analyst tools that span EDGAR-sourced US filings alongside European ESEF and EM markets in a single consistent data model. Trial keys are available on request; the web product is free and publicly indexed, so coverage is verifiable before integration.

Filings indexed
4,969,258
in United States
Listed companies
5,441
American issuers
Auth
x-api-key
single header
Webhook latency
< 1 min
from regulator publish

Reporting at a glance — United States

Regulator, indices, accounting, language
Primary indices
S&P 500Dow Jones Industrial AverageNasdaq 100Russell 2000
Accounting standards
US GAAP (IFRS permitted for foreign private issuers)
Reporting languages
English
Fiscal year
Calendar year predominant; non-calendar fiscal years common

Quick start — United States filings

REST · JSON · Markdown · PDF
# 1. List filings for United States, newest first
curl "https://api.financialreports.eu/api/filings/?countries=US" \
    -H "x-api-key: $FR_API_KEY"

# 2. Pull full Markdown for one filing
curl https://api.financialreports.eu/api/filings/<id>/markdown/ \
    -H "x-api-key: $FR_API_KEY"

# 3. Filter by filing type — annual reports only
curl "https://api.financialreports.eu/api/filings/?countries=US&type=10-K" \
    -H "x-api-key: $FR_API_KEY"

# 4. Filter by ISIN (single issuer)
curl "https://api.financialreports.eu/api/filings/?company_isin=DE000A1EWWW0" \
    -H "x-api-key: $FR_API_KEY"

Full API documentation ↗ · Interactive Swagger ↗

Sample United States response

Real filings · live data

Get API access for United States

Pricing · trial keys · enterprise
Get API access Talk to the team Read the docs ↗

Filings activity by year

Last 6 years · American issuers
  • 2026 104,355
  • 2025 438,032
  • 2024 429,586
  • 2023 377,983
  • 2022 339,910
  • 2021 341,519

Reporting languages

Filing-by-filing distribution
  • English 4,961,528
  • Turkish 1,863
  • Korean 1,589
  • Hebrew (modern) 1,546
  • Portuguese 726

FAQ — United States

Coverage, formats, integration
How do I authenticate API requests for United States filings?
Send a single header — `x-api-key: $FR_API_KEY` — on every request. The same key works across all 42 covered markets; there's no per-country key.
What format does the United States API return?
Filing metadata is returned as JSON. Full filing bodies are available as Markdown (one endpoint) and original PDF. The same payload shape is used across every covered market.
Do you provide webhooks for new American filings?
Yes. Webhook subscribers receive a POST with full filing metadata within ~60 seconds of the regulator publishing the document.
Is there a rate limit on the American API?
Standard plans are throttled to a generous request budget that suits typical research and dashboards. Bulk and high-throughput plans negotiate higher limits.
Is there a free tier for United States data?
The web product (search, browse, single-filing read) is free and indexed for the public web. Programmatic API access is a paid plan; trial keys are available on request.