API Reference

The Silmarl API gives you programmatic access to plain-language summaries of SEC filings. Submit a company name or CIK and get back a structured analysis powered by real EDGAR data and Claude AI.

All API requests are made to:

https://silmarl.com/api/v1

Authentication

All requests must include your API key in the X-API-Key header. You can get your API key from your dashboard.

curl https://silmarl.com/api/v1/search?q=Apple \
  -H "X-API-Key: your_api_key_here"

Keep your API key secret. Do not expose it in client-side code or public repositories.

Endpoints

GET/v1/searchSearch for companies by name or ticker

GET/v1/summaryGet an AI summary of a filing

GET/api/auth/usageCheck your usage and plan

GET

/v1/search

Search for public companies by name. Returns matching companies with their ticker symbol and CIK. Use the CIK in subsequent calls to /v1/summary for precise results.

Query parameters

qrequired

stringCompany name to search for. Minimum 2 characters.

curl "https://silmarl.com/api/v1/search?q=Apple" \
  -H "X-API-Key: your_api_key_here"

Response

{
  "object": "list",
  "query": "Apple",
  "results": [
    {
      "name": "Apple Inc",
      "ticker": "AAPL",
      "cik": "0000320193"
    }
  ]
}

GET

/v1/summary

Fetch and summarize the latest SEC filing for a company. Returns a structured plain-language analysis including financial performance, risks, red flags, and a bottom line. Powered by real EDGAR filing text and XBRL financial data.

Query parameters

companyrequired

stringCompany name or ticker. Example: "Apple" or "AAPL".

cik

stringCompany CIK from /v1/search. Recommended for precision, avoids ambiguity.

form_type

stringFiling type. One of: 10-K, 10-Q, 8-K. Defaults to "10-K".

section

stringReturn only one section of the summary. See response format for available keys.

curl "https://silmarl.com/api/v1/summary?company=Apple&cik=0000320193&form_type=10-K" \
  -H "X-API-Key: your_api_key_here"

Response

{
  "object": "summary",
  "company": "Apple Inc",
  "cik": "0000320193",
  "form_type": "10-K",
  "filing_date": "2024-11-01",
  "accession_number": "0000320193-24-000123",
  "summary": "**What the company does**\nApple designs and sells..."
}

GET

/api/auth/usage

Returns your current plan, monthly summary usage, and account details. No query parameters; authentication is via X-API-Key header only.

curl https://silmarl.com/api/auth/usage \
  -H "X-API-Key: your_api_key_here"

Response

{
  "email": "you@example.com",
  "plan": {
    "id": "free",
    "name": "Free",
    "price_usd": 0,
    "monthly_quota": 15,
    "hourly_rate_limit": 10
  },
  "usage": {
    "billing_month": "2026-04",
    "summaries_used": 3,
    "summaries_remaining": 12,
    "total_requests": 47
  },
  "account": {
    "created_at": "2026-01-15T10:00:00.000Z",
    "last_used": "2026-04-09T08:32:00.000Z"
  }
}

Response format

The sections object in the summary response contains these keys. Pass any key as the section param to get just that section.

overviewWhat the company does, business model and segments

financialsRevenue, gross profit, net income with real numbers

trajectoryIs the business getting better or worse? YoY trends

industry_metricsSector-specific KPIs (ARR, same-store sales, etc.)

leadershipKey executives, insider ownership, recent changes

outlookWhat management is betting on, guidance and strategy

red_flagsDilution, debt load, going concern, and other risks

verdictPlain-language bottom line for a retail investor

Example: fetch only the verdict:

curl "https://silmarl.com/api/v1/summary?company=Apple&section=verdict" \
  -H "X-API-Key: your_api_key_here"

Errors

Errors return a JSON object with an error field describing the problem.

401UnauthorizedMissing or invalid API key

400Bad RequestMissing or invalid query parameter

404Not FoundNo filing found for this company / form type, or section key not found

429Rate LimitedHourly request limit or monthly summary quota exceeded. Check X-RateLimit-* headers.

500Server ErrorSomething went wrong on our end

{
  "error": "Missing required parameter: company"
}