微信扫一扫Use curl to call the endpoint below. Server runs at https://labs.lovelace.ai/sec/api. Every request requires entity (company name, ticker, or CIK).
Each response includes a company profile (SIC code, state/country of incorporation, fiscal year end) and, for annual (10-K) and quarterly (10-Q) filings, extracted financial metrics: revenue, net income, total assets, and stockholders' equity.
/filings — list SEC filings
# By company name
curl "https://labs.lovelace.ai/sec/api/filings?entity=Apple&form_types=10-K&limit=4"
# By ticker
curl "https://labs.lovelace.ai/sec/api/filings?entity=NVDA&limit=5"
# By CIK
curl "https://labs.lovelace.ai/sec/api/filings?entity=320193"
# With date range (both bounds inclusive, YYYY-MM-DD)
curl "https://labs.lovelace.ai/sec/api/filings?entity=Microsoft&form_types=10-K,10-Q&after=2023-01-01"
curl "https://labs.lovelace.ai/sec/api/filings?entity=Microsoft&form_types=10-K&after=2020-01-01&before=2022-12-31"
# Markdown output
curl -H "Accept: text/markdown" "https://labs.lovelace.ai/sec/api/filings?entity=Apple&form_types=10-K&limit=3"
Parameters
| Param | Required | Description |
|-------|----------|-------------|
| entity | yes | Company name, ticker symbol, or CIK (max 256 chars) |
| form_types | no | Comma-separated list. Omit for all supported types. |
| limit | no | Max results (default 10, max 50) |
| after | no | Inclusive lower bound on filing date, YYYY-MM-DD |
| before | no | Inclusive upper bound on filing date, YYYY-MM-DD |
Valid form types
Use these values in form_types to narrow results. Omit to return all types.
| Value | What it is | When to use |
|-------|-----------|-------------|
| 10-K | Annual Report | Full-year financial results, risk factors, business overview |
| 10-Q | Quarterly Report | Quarterly financials and updates between annual reports |
| 8-K | Current Report | Material events: earnings releases, M&A, leadership changes, etc. |
| 4 | Insider Ownership Changes | Trades or grants of shares by officers, directors, or 10%+ holders |
| SC 13D | Activist Stake Disclosure | Filed when an investor acquires >5% with intent to influence the company |
| SC 13G | Passive Stake Disclosure | Filed when an investor acquires >5% passively (no influence intent) |
| 13F-HR | Institutional Holdings | Quarterly snapshot of a fund's equity holdings (≥$100M AUM required) |
| DEF 14A | Proxy Statement | Shareholder meeting agenda: board elections, exec pay, governance votes |
Response
JSON object with top-level identity fields, a company profile, and a filings
array. Results are sorted most-recent first.
Top-level fields
| Field | Description |
|-------|-------------|
| name | Canonical entity name (e.g. "Apple Inc.") |
| cik | SEC CIK (e.g. "0000320193") |
| alternatives | Other close-match entities found during search (omitted when empty) |
name and cik are present even when filings is empty, letting you confirm
which entity was found.
alternatives is a list of objects, each with name and cik, representing
other entities the server considered as matches. If the results look wrong, retry
with ?entity=<alternative_cik> to pin directly to a specific entity — CIK
lookups bypass fuzzy matching entirely.
company fields
| Field | Description |
|-------|-------------|
| sic_code | Standard Industrial Classification code |
| state_of_incorporation | State or jurisdiction of incorporation |
| country_of_incorporation | Country of incorporation |
| fiscal_year_end | Fiscal year end date (MMDD, e.g. 0930 = September 30) |
| employees | Total full-time equivalent employees |
All company fields are omitted when not available in the KG.
filings fields
| Field | Description |
|-------|-------------|
| form_type | Filing type (e.g. 10-K, 8-K) |
| date | Filing date (YYYY-MM-DD) |
| accession_number | SEC accession number |
| cik | Company CIK |
| description | Human-readable filing description |
| edgar_url | Direct link to the filing index on SEC EDGAR |
| data | Extracted financial metrics (10-K/10-Q only; null for other form types) |
data fields (10-K and 10-Q only)
| Field | Description |
|-------|-------------|
| fiscal_year | Fiscal year the filing covers (e.g. 2024) |
| fiscal_period | Fiscal period (FY, Q1, Q2, Q3, Q4) |
| revenue | Total revenue (USD) |
| net_income | Net income / profit (USD) |
| total_assets | Total assets (USD) |
| stockholders_equity | Stockholders' equity (USD) |
All data fields are omitted when not available in the KG.
{
"name": "Apple Inc.",
"cik": "0000320193",
"company": {
"sic_code": "3571",
"state_of_incorporation": "CA",
"fiscal_year_end": "0928"
},
"filings": [
{
"form_type": "10-K",
"date": "2024-11-01",
"accession_number": "0000320193-24-000123",
"cik": "0000320193",
"description": "Annual Report (Form 10-K)",
"edgar_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm",
"data": {
"fiscal_year": 2024,
"fiscal_period": "FY",
"revenue": 391035000000,
"net_income": 93736000000,
"total_assets": 364980000000,
"stockholders_equity": 56950000000
}
}
]
}
Add -H "Accept: text/markdown" for a human-readable markdown response instead of JSON.
Example prompts
These prompts work well with this skill:
- "Show me Apple's last 3 annual reports with revenue and net income"
- "What was Microsoft's revenue and net income in their most recent quarter?"
- "Compare Amazon and Google's total assets from their latest 10-Ks"
- "What 8-Ks has Nvidia filed in the last 90 days?"
- "Find all insider trades at Meta since January"
- "Who are the large passive shareholders of Microsoft? Show me their SC 13G filings"
- "Pull Berkshire Hathaway's last two proxy statements"
- "Has Amazon made any material event disclosures this quarter?"
Errors
| HTTP status | Meaning |
|-------------|---------|
| 400 | Bad request — missing entity, invalid after/before format, or unrecognised form_types |
| 404 | Entity not found — try a different name, the ticker symbol, or the CIK |
| 500 | Internal error — retry once; if it persists the server may be unavailable |
| 503 | Server starting up — retry after a few seconds |
By using this skill you agree to the Lovelace AI Terms and Conditions.