API Reference

The Silmarl API gives you programmatic access to filing audits of SEC documents. Submit a company name or CIK and get back a structured risk analysis covering dilution, liquidity, leverage, concentration, governance, and competition, 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 risk audit 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 (the filing audit endpoint) 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 a risk audit of the latest SEC filing for a company. Returns a structured analysis with a six-category risk scorecard (dilution, liquidity, leverage, concentration, governance, competition), severity-rated flags with citations, and a bottom-line risk posture. 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 audit. 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": "filing_audit",
  "company": "Apple Inc",
  "cik": "0000320193",
  "form_type": "10-K",
  "filing_date": "2024-11-01",
  "accession_number": "0000320193-24-000123",
  "scorecard": [
    { "dimension": "Dilution",      "rating": "Low",    "reason": "..." },
    { "dimension": "Liquidity",     "rating": "Low",    "reason": "..." },
    { "dimension": "Leverage",      "rating": "Medium", "reason": "..." },
    { "dimension": "Concentration", "rating": "Medium", "reason": "..." },
    { "dimension": "Governance",    "rating": "Low",    "reason": "..." },
    { "dimension": "Competition",   "rating": "Medium", "reason": "..." }
  ],
  "sections": {
    "context":     "Apple designs and sells...",
    "flags":       "- MED: Concentration. iPhone 51% of revenue [S3]\n- ...",
    "bottom_line": "Low overall risk..."
  },
  "audit_text": "**Context**\nApple designs and sells..."
}

GET

/api/auth/usage

Returns your current plan, monthly filing audit 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 filing audit response contains these keys. Pass any key as the section param to get just that section.

contextOne-line description of the company and the filing being audited

what_happened8-K only: the material event being disclosed

flagsSeverity-rated risks (HIGH / MED / LOW) by category, with citations

what_changedRisks that appeared, resolved, or shifted severity vs. prior filing

bottom_line2-3 sentence overall risk posture for a retail investor

The top-level response also includes a scorecard object: each of the six risk categories (Dilution, Liquidity, Leverage, Concentration, Governance, Competition) rated Low / Medium / High with a one-line reason. Low means low risk.

Example: fetch only the bottom line:

curl "https://silmarl.com/api/v1/summary?company=Apple&section=bottom_line" \
  -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 filing audit quota exceeded. Check X-RateLimit-* headers.

500Server ErrorSomething went wrong on our end

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

API Reference

All API requests are made to:

https://silmarl.com/api/v1

{ "object": "filing_audit", "company": "Apple Inc", "cik": "0000320193", "form_type": "10-K", "filing_date": "2024-11-01", "accession_number": "0000320193-24-000123", "scorecard": [ { "dimension": "Dilution", "rating": "Low", "reason": "..." }, { "dimension": "Liquidity", "rating": "Low", "reason": "..." }, { "dimension": "Leverage", "rating": "Medium", "reason": "..." }, { "dimension": "Concentration", "rating": "Medium", "reason": "..." }, { "dimension": "Governance", "rating": "Low", "reason": "..." }, { "dimension": "Competition", "rating": "Medium", "reason": "..." } ], "sections": { "context": "Apple designs and sells...", "flags": "- MED: Concentration. iPhone 51% of revenue [S3]\n- ...", "bottom_line": "Low overall risk..." }, "audit_text": "**Context**\nApple designs and sells..." }

{ "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 filing audit response contains these keys. Pass any key as the section param to get just that section.

contextOne-line description of the company and the filing being audited

what_happened8-K only: the material event being disclosed

flagsSeverity-rated risks (HIGH / MED / LOW) by category, with citations

what_changedRisks that appeared, resolved, or shifted severity vs. prior filing

bottom_line2-3 sentence overall risk posture for a retail investor

Example: fetch only the bottom line:

curl "https://silmarl.com/api/v1/summary?company=Apple&section=bottom_line" \
  -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 filing audit quota exceeded. Check X-RateLimit-* headers.

500Server ErrorSomething went wrong on our end

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