SEC EDGAR API
SEC EDGAR filings data with full-text search, XBRL company facts, and filing details — flattened, enriched with filing type descriptions, and optimized for agent consumption.
Full-text search across SEC filings. Flattens nested EFTS response, adds human-readable filing type descriptions, and formats dates consistently.
| Parameter | Type | Description |
|---|---|---|
query | string | Search query (required) |
dateRange | string | Date range filter (e.g., "custom", "30d", "1y") |
form | string | Filing type filter (e.g., "10-K", "10-Q", "8-K") |
# Direct call (no L402) curl "https://agent-commerce.store/api/edgar/search?query=artificial+intelligence&form=10-K" # Via L402 proxy (paid) curl "https://api.lightningenable.com/l402/proxy/{proxyId}/search?query=artificial+intelligence&form=10-K"
Response includes formTypeDescription for each filing (e.g., "Annual report — comprehensive overview of financial performance") and direct filingUrl links.
Get company XBRL facts and recent filings in a single call. Combines data from two SEC endpoints (company facts + EFTS search) and extracts key financial metrics.
| Parameter | Type | Description |
|---|---|---|
cik | string | Central Index Key (e.g., "320193" for Apple) |
# Apple Inc. (CIK auto-padded to 10 digits) curl "https://agent-commerce.store/api/edgar/company/320193" # Microsoft Corp. curl "https://agent-commerce.store/api/edgar/company/789019"
Response includes extracted keyFacts (Revenue, Net Income, EPS, etc.) with most recent values, plus recentFilings from the last 30 days.
Get filing details by accession number with parsed metadata and filing type description.
| Parameter | Type | Description |
|---|---|---|
accessionNumber | string | SEC accession number (e.g., "0000320193-23-000106") |
curl "https://agent-commerce.store/api/edgar/filing/0000320193-23-000106"
form parameter filters by filing type — common values are 10-K (annual), 10-Q (quarterly), and 8-K (current events).
Value-Add
- Single-call company endpoint combines XBRL facts + recent filings (2 SEC API calls)
- Filing type descriptions — human-readable explanations for 20+ SEC form types
- CIK auto-padding — pass any CIK and it gets padded to 10 digits automatically
- Flattened JSON — nested EFTS search results transformed into flat, agent-friendly records
- Key financial facts extracted from XBRL data (Revenue, Net Income, EPS, Assets, etc.)
- Direct filing URLs constructed for each result
- Consistent date formatting across all responses
Upstream Source
SEC EDGAR Full-Text Search (EFTS) and SEC EDGAR API — public domain, no API key required. Requires User-Agent header with contact information.