SEC EDGAR

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.

​

Endpoints

​

Lookup company tickers and CIK numbers

const data = await lava.gateway('https://www.sec.gov/files/company_tickers.json', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fwww.sec.gov%2Ffiles%2Fcompany_tickers.json" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

​

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

const data = await lava.gateway('https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.json', { method: 'GET' });

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"

​

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).

const data = await lava.gateway('https://data.sec.gov/submissions/CIK0000320193.json', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdata.sec.gov%2Fsubmissions%2FCIK0000320193.json" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

​

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.

const data = await lava.gateway('https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json', { method: 'GET' });

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"

​

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”.

const data = await lava.gateway('https://data.sec.gov/api/xbrl/companyconcept/CIK0000320193/us-gaap/NetIncomeLoss.json', { method: 'GET' });

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"

​

Get cross-company XBRL snapshot for a period

​

Full-text filing search

const data = await lava.gateway('https://efts.sec.gov/LATEST/search-index?q=artificial+intelligence&forms=10-K', { method: 'GET' });

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"

​

Next Steps