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

# SEC EDGAR

> SEC's EDGAR system providing corporate filings (10-K, 10-Q, 8-K), XBRL structured financial data, and full-text search across all SEC submissions.

SEC's EDGAR system providing corporate filings (10-K, 10-Q, 8-K), XBRL structured financial data, and full-text search across all SEC submissions. Best for fundamental analysis, regulatory compliance monitoring, and extracting structured financial statements from public companies. The authoritative source for U.S. securities filings — no commercial alternative has more complete coverage.

7 endpoints available through Lava's AI Gateway. See the [SEC EDGAR API docs](https://www.sec.gov/developer) for full documentation.

<Info>This provider is **managed** — no additional setup required.</Info>

## Endpoints

### Lookup company tickers and CIK numbers

**GET** `https://www.sec.gov/files/company_tickers.json` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://www.sec.gov/files/company_tickers.json', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fwww.sec.gov%2Ffiles%2Fcompany_tickers.json" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### Fetch raw filing documents from the EDGAR archive (Form 4 XML, 10-K/10-Q HTML, exhibits)

**GET** `https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.json` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.json', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fwww.sec.gov%2FArchives%2Fedgar%2Fdata%2F320193%2F000032019324000123%2F0000320193-24-000123-index.json" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### Company profile and filings list. Lava projects `filings.recent.*` to the 25 most-recent filings (parallel-array slice newest-first by `filingDate`) and drops the `filings.files` paginated-chunks pointer. The transform emits a `_lava_truncated` hint with `{kept, available}` plus the upstream `available_forms` set so the agent knows which form types to filter on. Override with filter.\_lava\_max\_filings=N, filter.\_lava\_forms="10-K,10-Q,8-K", or filter.mode="full" for the raw payload (\~190 KB for mature companies).

**GET** `https://data.sec.gov/submissions/CIK0000320193.json` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://data.sec.gov/submissions/CIK0000320193.json', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdata.sec.gov%2Fsubmissions%2FCIK0000320193.json" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### Full XBRL fact dump for a company (every us-gaap concept × every reporting period). The raw payload is enormous — Apple is \~4.4 MB across 503 concepts, with concepts like NetIncomeLoss carrying 330+ entries. Lava strips per-concept `description` strings, caps each `units.{currency}` array to the 20 most-recent entries (newest-first by `end` date), and emits a per-concept `_lava_truncated` hint. Override with filter.\_lava\_concepts="Revenues,NetIncomeLoss,Assets" to project to a concept allow-list, filter.\_lava\_max\_periods=N to widen the time cap, filter.\_lava\_forms="10-K,10-Q" to filter by form type, filter.\_lava\_keep\_descriptions="true" to opt back into XBRL descriptions, or filter.mode="full" for the raw payload.

**GET** `https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdata.sec.gov%2Fapi%2Fxbrl%2Fcompanyfacts%2FCIK0000320193.json" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### Single XBRL concept time series for a company (e.g. all reported `Revenues` entries across every 10-K/10-Q). Lava caps `units.{currency}` to the 20 most-recent entries newest-first and strips the verbose XBRL `description`. Override with filter.\_lava\_max\_periods=N, filter.\_lava\_forms="10-K,10-Q", filter.\_lava\_keep\_description="true", or filter.mode="full".

**GET** `https://data.sec.gov/api/xbrl/companyconcept/CIK0000320193/us-gaap/NetIncomeLoss.json` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://data.sec.gov/api/xbrl/companyconcept/CIK0000320193/us-gaap/NetIncomeLoss.json', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdata.sec.gov%2Fapi%2Fxbrl%2Fcompanyconcept%2FCIK0000320193%2Fus-gaap%2FNetIncomeLoss.json" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### Get cross-company XBRL snapshot for a period

**GET** `https://data.sec.gov/api/xbrl/frames/{id}.json` — Free

### Full-text filing search

**GET** `https://efts.sec.gov/LATEST/search-index?q=artificial+intelligence&forms=10-K` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://efts.sec.gov/LATEST/search-index?q=artificial+intelligence&forms=10-K', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fefts.sec.gov%2FLATEST%2Fsearch-index%3Fq%3Dartificial%2Bintelligence%26forms%3D10-K" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={2}>
  <Card title="All Providers" icon="grid" href="/gateway/supported-providers">
    Browse all supported AI providers
  </Card>

  <Card title="Forward Proxy" icon="route" href="/gateway/forward-proxy">
    Learn how to construct proxy URLs and authenticate requests
  </Card>
</CardGroup>
