FocusAlphaDocs
Get key
API Reference

Filings

List a company's SEC filings — the discovery endpoint for everything else. Resolve a ticker or CIK to its filing history (10-K, 10-Q, 8-K, and more), each with the accession number and primary-document URL you pass to the other SEC endpoints.

GET/v1/filings

Filings come straight from SEC EDGAR — no third-party redistribution. Provide a ticker or cik; optionally narrow by form type and filing date. Results are newest-first.

Query parameters#

tickerstringoptional
US ticker, e.g. AAPL. Provide ticker or cik (at least one is required).
cikstringoptional
SEC Central Index Key, e.g. 320193 (zero-padding optional). An alternative to ticker.
filing_typestring | string[]optional
One or more form types to include — 10-K, 10-Q, 8-K, 20-F, 6-K, DEF 14A, S-1, 424B4, and the /A amendments. Repeat the param to include multiple forms (?filing_type=10-K&filing_type=10-Q) — a comma-separated value is rejected as an invalid form type (400). Omit to return all forms.
limitnumberoptional
Max filings to return. Defaults to 10 (minimum 1).
filed_at_gtestringoptional
Only filings filed on or after this date (YYYY-MM-DD). Also available: filed_at_lte, filed_at_gt, filed_at_lt.

Example request#

curlbash
curl "https://api.focusalpha.ai/v1/filings?ticker=AAPL&filing_type=10-K" \
  -H "X-API-Key: $FOCUSALPHA_API_KEY"

Response#

Returns a filings array, newest first. Each entry carries the identifiers you feed to the Filing Items, Financials, and Financial Metrics endpoints.

filing#

tickerstringrequired
Company ticker.
ciknumberrequired
SEC Central Index Key.
filing_typestringrequired
The form type, e.g. 10-K.
accession_numberstringrequired
The SEC accession number, e.g. 0000320193-24-000123. The stable handle for this exact filing — pass it to /v1/filings/items (required for 8-K).
report_datestringrequired
The period the filing reports on (YYYY-MM-DD) — the fiscal period end. For forms without an EDGAR period-of-report (e.g. some 8-Ks), report_date falls back to the filing_date.
filing_datestringrequired
The date the filing was submitted to the SEC (YYYY-MM-DD).
urlstringrequired
Direct link to the primary document on SEC EDGAR.

Example response#

response.jsonjson
{
  "filings": [
    {
      "cik": 320193,
      "accession_number": "0000320193-24-000123",
      "filing_type": "10-K",
      "report_date": "2024-09-28",
      "filing_date": "2024-11-01",
      "ticker": "AAPL",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"
    }
  ]
}

Available form types#

The form types currently surfaced by discovery: 10-K, 10-Q, 8-K, 20-F, 6-K, DEF 14A, S-1, 424B4, 10-K/A, 10-Q/A, 8-K/A. Fetch this list at runtime from GET /v1/filings/types.

Item-level parsing is 10-K / 10-Q / 8-K
Discovery lists every form type above. The Filing Items endpoint — which splits a filing into its individual numbered Items — currently supports 10-K, 10-Q, and 8-K.

Discovery endpoints#

Lightweight lookups for the covered universe and the parsing vocabulary. These take no query parameters and return plain lists.

GET /v1/filings/tickersGEToptional
Every covered ticker: { resource: "filings", tickers: [...] }.
GET /v1/filings/ciksGEToptional
Every covered CIK (zero-padded to 10): { resource: "filings", ciks: [...] }.
GET /v1/filings/typesGEToptional
The form types surfaced by discovery (listed above): { filing_types: [...] }.
GET /v1/filings/items/typesGEToptional
The item definitions per filing type, used by Filing Items — a keyed map of filing-type to its numbered items.

Errors#

Standard statuses: 400 (missing both ticker and cik, or an invalid form type), 401 (bad or missing API key), 402 (rate limit or monthly quota exceeded — fd-parity returns Payment Required, not 429), 404 (unknown ticker or CIK — issuer not found; a known company with no matching filings returns 200 with an empty filings array). See Errors.