SEC Filings

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

Valid form types

Use these values in form_types to narrow results. Omit to return all types.

Response

JSON object with top-level identity fields, a company profile, and a filings

array. Results are sorted most-recent first.

Top-level fields

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= to pin directly to a specific entity — CIK

lookups bypass fuzzy matching entirely.

company fields

All company fields are omitted when not available in the KG.

filings fields

data fields (10-K and 10-Q only)

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

By using this skill you agree to the Lovelace AI Terms and Conditions.