{"openapi":"3.1.0","info":{"title":"x402 SEC Filings API","version":"2.0.0","description":"Pay-per-call SEC EDGAR filing-health check.","x-guidance":"Use GET /filing-check/{cik} for a computed filing-health verdict (late-filing notifications, restatements, overdue periodic reports) for one company CIK. You are charged only for an actual verdict — an unknown CIK or a company with no filings to assess returns 404 and costs nothing. Use the free GET /company-lookup?name={company} to resolve a CIK first.","x-payment-policy":"NEVER CHARGED FOR AN UNDELIVERABLE ANSWER. The x402 middleware cancels settlement for any response >= 400, so every error below moves $0.00 and emits no payment-response header. In particular a company with no filings in the lookback window is returned as 404 insufficient_filing_data rather than a billed 200 saying 'insufficient_data'."},"paths":{"/filing-check/{cik}":{"get":{"operationId":"filingCheck","summary":"SEC filing-health verdict","tags":["Finance"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"cik","in":"path","required":true,"schema":{"type":"string"},"description":"SEC CIK, up to 10 digits, e.g. 0000320193"}],"responses":{"200":{"description":"A real filing-health verdict: `normal_cadence` or `gaps_or_late_filings_detected`, with the supporting flags. The only response you are charged for."},"400":{"description":"NOT CHARGED. `invalid_cik` — the path segment is not a valid SEC CIK."},"402":{"description":"Payment Required"},"404":{"description":"NOT CHARGED. `cik_not_found` (EDGAR holds no submissions for this CIK) or `insufficient_filing_data` (the company has no filings in the lookback window, so no cadence/lateness verdict can be computed). Both `retryable:false`.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["cik_not_found","insufficient_filing_data"]},"message":{"type":"string"},"charged":{"type":"boolean","enum":[false]},"retryable":{"type":"boolean","enum":[false]},"cik":{"type":"string"},"filingsAnalyzed":{"type":"integer"}}}}}},"405":{"description":"NOT CHARGED. Wrong HTTP verb for this resource; see the Allow header."},"502":{"description":"NOT CHARGED. `edgar_upstream_unavailable` — SEC EDGAR did not answer. `retryable:true`."}}}}}}