SEC Filings

A company's SEC filing history, filtered to the most meaningful form types and returned newest first. Each row carries citation fields plus the primary document and XBRL URLs.

Endpoint

GET /v1/company/{identifier}/filings

{identifier} is a ticker or numeric CIK.

Query parameters

| Parameter | Type | Default | Description | | --- | --- | --- | --- | | limit | integer | 50 | Rows to return, 1–500. | | offset | integer | 0 | Zero-based row offset for pagination. |

The endpoint surfaces these form types by default: 10-K, 10-Q, 8-K, 13F-HR, NPORT-P, and S-1.

Citation fields

form — the filing form type (mapped from the underlying form_type column).
filing_date — the SEC submission date.
period — the reporting period-end date.
fiscal_year — the fiscal year the filing covers.
filed_as_reported — always true for filings rows.

Sample request

curl "https://api.financialdataapis.com/v1/company/AAPL/filings?limit=2" \
  -H "X-API-Key: $FDA_KEY"

Sample response

{
  "data_source": "SEC EDGAR",
  "items": [
    {
      "id": 9,
      "cik": 320193,
      "accession_number": "0000320193-25-000123",
      "form": "10-K",
      "filing_date": "2025-10-31",
      "period": "2025-09-30",
      "fiscal_year": 2025,
      "fiscal_period": "FY",
      "primary_doc_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000123/",
      "xbrl_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000123/aapl-20250930.htm",
      "ingested_at": "2026-01-01T00:00:00",
      "filed_as_reported": true
    }
  ]
}

Error codes

| Status | Code | Meaning | | --- | --- | --- | | 401 | key_invalid | Missing or invalid API key. | | 404 | — | Unknown ticker or CIK: {id}. | | 422 | — | limit outside 1–500 or offset < 0. | | 429 | MONTHLY_QUOTA_EXCEEDED | Monthly quota exhausted. |