U.S. SEC EDGAR

Name: U.S. SEC EDGAR
Creator: U.S. SEC EDGAR
License: https://www.usa.gov/government-works

Open · redistributedU.S. Government Work (public domain)fundamentals

Redistributable. This source is served as canonical Parquet under the license below, with attribution and provenance preserved.

Important notes

Company XBRL fundamentals; the SEC 'filed' date is kept as vintage_date (point-in-time), so a (metric, period) can repeat across filings.

Coverage

Series catalogued

17,274

Temporal coverage

1927-02-17 – present

Frequencies

Quarterly

Distinct geographies

Licensing & provenance

License: U.S. Government Work (public domain)
License URL: https://www.usa.gov/government-works
Required attribution: Source: U.S. SEC EDGAR (public domain)
Redistribution: Permitted (served here)
Commercial use: Yes
Modification: Permitted
Provider homepage: https://www.sec.gov/edgar
Provider terms: https://www.sec.gov/edgar

How to cite

U.S. Securities and Exchange Commission (EDGAR company facts). Retrieved from https://www.sec.gov/edgar. Compiled and redistributed by the Elkassabgi Data Library.

Processing: Retrieved from the official source, normalized to a long {series_key, obs_date, value} schema (period-start dates), de-duplicated, and stored as zstd Parquet. Compiled and redistributed by the Elkassabgi Data Library.

Access & mirrors

Download: Select & download sec_edgar series as CSV →
API: Get a free API key, then GET /v1/series/<id>.csv
Canonical landing: https://econdatalibrary.com/sec_edgar.html
Update cadence: daily
Update strategy: bulk snapshot if changed
Storage layout: TWO stages. Raw: data/raw/sec_edgar/companyfacts.zip + submissions.zip (~2.9GB combined) from this fetch script. Clean: one parquet per ticker/identifier under data/clean_grouped/sec_edgar/<TICKER>.parquet (~17,274 files) written by the separate jobs/ingest_sec_edgar.py — note this lands in clean_grouped, NOT clean_full (clean_full/sec_edgar is empty). ~123M obs total.

Full description

Phase-0 bootstrap: download the SEC EDGAR bulk archives for the initial backfill. companyfacts.zip (~1.39 GB) -- every company's XBRL financial-statement facts (the NUMBERS we host) submissions.zip (~1.54 GB) -- every filing's metadata (the POINTERS we index; documents stay on sec.gov) Polite by design: descriptive User-Agent (SEC requires it or returns 403), streamed to disk, resumable (HTTP Range), retried. Source: U.S. SEC EDGAR (public domain). Run: python jobs/fetch_sec_edgar_bulk.py

Structured metadata

schema.org/Dataset (Google Dataset Search)

{
  "@context": "https://schema.org/",
  "@type": "Dataset",
  "name": "U.S. SEC EDGAR",
  "description": "Phase-0 bootstrap: download the SEC EDGAR bulk archives for the initial backfill. companyfacts.zip (~1.39 GB) -- every company's XBRL financial-statement facts (the NUMBERS we host) submissions.zip (~1.54 GB) -- every filing's metadata (the POINTERS we index; documents stay on sec.gov) Polite by…",
  "url": "https://econdatalibrary.com/sec_edgar.html",
  "identifier": "sec_edgar",
  "isAccessibleForFree": true,
  "publisher": {
    "@type": "Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "creator": {
    "@type": "Organization",
    "name": "U.S. SEC EDGAR",
    "url": "https://www.sec.gov/edgar"
  },
  "license": "https://www.usa.gov/government-works",
  "keywords": [
    "fundamentals",
    "sec_edgar"
  ],
  "temporalCoverage": "1927-02-17/..",
  "repeatFrequency": "P3M",
  "citation": "U.S. Securities and Exchange Commission (EDGAR company facts). Retrieved from https://www.sec.gov/edgar. Compiled and redistributed by the Elkassabgi Data Library.",
  "sameAs": [
    "https://huggingface.co/datasets/econdatalibrary-sec_edgar",
    "https://zenodo.org/communities/econdatalibrary"
  ],
  "distribution": [
    {
      "@type": "DataDownload",
      "encodingFormat": "text/csv",
      "contentUrl": "https://econdatalibrary.com/download.html?source=sec_edgar",
      "license": "https://www.usa.gov/government-works"
    }
  ]
}

Croissant (ML-ready, schema.org JSON-LD)

{
  "@context": {
    "@language": "en",
    "@vocab": "https://schema.org/",
    "cr": "http://mlcommons.org/croissant/",
    "data": {
      "@id": "cr:data",
      "@type": "@json"
    },
    "dataType": {
      "@id": "cr:dataType",
      "@type": "@vocab"
    },
    "sc": "https://schema.org/",
    "conformsTo": "dct:conformsTo",
    "dct": "http://purl.org/dc/terms/"
  },
  "@type": "sc:Dataset",
  "conformsTo": "http://mlcommons.org/croissant/1.0",
  "name": "sec_edgar",
  "description": "Phase-0 bootstrap: download the SEC EDGAR bulk archives for the initial backfill. companyfacts.zip (~1.39 GB) -- every company's XBRL financial-statement facts (the NUMBERS we host) submissions.zip (~1.54 GB) -- every filing's metadata (the POINTERS we index; documents stay on sec.gov) Polite by…",
  "url": "https://econdatalibrary.com/sec_edgar.html",
  "creator": {
    "@type": "sc:Organization",
    "name": "U.S. SEC EDGAR"
  },
  "publisher": {
    "@type": "sc:Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "license": "https://www.usa.gov/government-works",
  "keywords": [
    "fundamentals"
  ],
  "citation": "U.S. Securities and Exchange Commission (EDGAR company facts). Retrieved from https://www.sec.gov/edgar. Compiled and redistributed by the Elkassabgi Data Library.",
  "distribution": [
    {
      "@type": "cr:FileObject",
      "@id": "sec_edgar-csv",
      "name": "sec_edgar-csv",
      "description": "Per-series CSV, downloadable with a free API key.",
      "contentUrl": "https://econdatalibrary.com/download.html?source=sec_edgar",
      "encodingFormat": "text/csv"
    }
  ]
}

Part of the Econ Data Library catalog · metadata generated 2026-07-14 from the central registry · browse all datasets