SEC EDGAR filings

The edgar source lets you look up a company’s SEC filings by name or ticker. A lookup can return the company’s most recent filing, or a list of its filings over a date range you choose. Which one you get depends on whether the request has from, to, or limit. Each filing in data.metadata.filings is charged as one request. See Plans and credits.

Getting one filing or a list

A request with none of from, to, and limit returns one filing in data, and data.metadata has no filings list. Adding form_type doesn’t change this. It picks which form that one filing is. A request with any of the three returns the newest matching filing in data and lists the matches in data.metadata.filings, newest first. The number listed depends on the request:

Request	Filings listed
No `from`, `to`, or `limit`	None
`from` or `to`, without `limit`	Up to 5
`limit`, with or without `from` and `to`	Up to the `limit`

A limit of 1 still returns the list, with one filing in it. The list is shorter than the limit when fewer filings match. Without an API key, a limit above 5 returns 401 with the code API_KEY_REQUIRED, before Dataville sends any request to the SEC, and you aren’t charged. See Troubleshooting. The parameters and their formats are on Search a data source.

Reading a filings list

Here is the result of GET /edgar/HD?form_type=10-Q&limit=4, with body shortened, the company fields in metadata removed, and each filing’s figures cut to revenue and net income:

{
  "status": "success",
  "account_state": "anonymous",
  "data": {
    "id": "edgar_0001628280-26-058715",
    "title": "HOME DEPOT, INC. — 10-Q (2026-08-25)",
    "body": "Company: HOME DEPOT, INC.\nForm: 10-Q\nFiled: 2026-08-25\nPeriod: 2026-08-02\n...",
    "source": "sec-edgar",
    "metadata": {
      "cik": "0000354950",
      "company_name": "HOME DEPOT, INC.",
      "form_type": "10-Q",
      "filing_date": "2026-08-25",
      "filings": [
        {
          "form_type": "10-Q",
          "filing_date": "2026-08-25",
          "report_date": "2026-08-02",
          "fiscal_year": 2026,
          "fiscal_period": "Q2",
          "accession_number": "0001628280-26-058715",
          "document_url": "https://www.sec.gov/Archives/edgar/data/354950/000162828026058715/hd-20260802.htm",
          "financials": { "form": "10-Q", "period_start": "2026-02-02", "period": "2026-08-02", "filed": "2026-08-25", "revenue": "$89.63B", "net_income": "$8.05B" },
          "financials_raw": { "revenue": 89626000000, "net_income": 8055000000 }
        },
        {
          "form_type": "10-Q",
          "filing_date": "2026-05-27",
          "report_date": "2026-05-03",
          "fiscal_year": 2026,
          "fiscal_period": "Q1",
          "accession_number": "0001628280-26-038247",
          "document_url": "https://www.sec.gov/Archives/edgar/data/354950/000162828026038247/hd-20260503.htm",
          "financials": { "form": "10-Q", "period_start": "2026-02-02", "period": "2026-05-03", "filed": "2026-05-27", "revenue": "$41.77B", "net_income": "$3.29B" },
          "financials_raw": { "revenue": 41765000000, "net_income": 3289000000 }
        },
        {
          "form_type": "10-Q",
          "filing_date": "2025-11-25",
          "report_date": "2025-11-02",
          "fiscal_year": 2025,
          "fiscal_period": "Q3",
          "accession_number": "0001628280-25-053868",
          "document_url": "https://www.sec.gov/Archives/edgar/data/354950/000162828025053868/hd-20251102.htm",
          "financials": { "form": "10-Q", "period_start": "2025-02-03", "period": "2025-11-02", "filed": "2025-11-25", "revenue": "$126.48B", "net_income": "$11.59B" },
          "financials_raw": { "revenue": 126485000000, "net_income": 11585000000 }
        },
        {
          "form_type": "10-Q",
          "filing_date": "2025-08-26",
          "report_date": "2025-08-03",
          "fiscal_year": 2025,
          "fiscal_period": "Q2",
          "accession_number": "0000354950-25-000217",
          "document_url": "https://www.sec.gov/Archives/edgar/data/354950/000035495025000217/hd-20250803.htm",
          "financials": { "form": "10-Q", "period_start": "2025-02-03", "period": "2025-08-03", "filed": "2025-08-26", "revenue": "$85.13B", "net_income": "$7.98B" },
          "financials_raw": { "revenue": 85133000000, "net_income": 7984000000 }
        }
      ]
    }
  }
}

data is Home Depot’s newest 10-Q, and filings lists four. Each listed 10-K, 10-Q, or 20-F has fiscal_year, fiscal_period, and figures for its own period only. On a 10-Q those figures are year to date, so the Q2 revenue covers six months.

Get started

Data

Working with data

Account

Getting one filing or a list

Reading a filings list

​Getting one filing or a list

​Reading a filings list

Getting one filing or a list

Reading a filings list