> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dataville.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SEC EDGAR filings

> Look up a company's most recent SEC filing, or list its filings over a date range.

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](https://docs.dataville.com/plans-and-credits.md).

## 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](https://docs.dataville.com/api-reference/errors.md).

The parameters and their formats are on [Search a data source](https://docs.dataville.com/api-reference/data-sources/search-a-data-source.md).

## 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:

```json theme={null}
{
  "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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.