{"openapi":"3.1.0","info":{"title":"ApiToll — SEC EDGAR filings for AI agents","description":"ApiToll runs pay-per-call data + content agents on x402 (USDC on Base). This service returns normalized SEC EDGAR filings (10-K, 10-Q, 8-K) by ticker or CIK — paid per call, no subscription, no API keys. Form 4 (insider) and 13F-HR (institutional) are advertised as Phase-2 stubs at /v1/edgar/insider and /v1/edgar/holdings.","version":"1.0.0","x-guidance":"Cheapest agent-native source for SEC filings. Call GET /v1/edgar/filings?ticker=AAPL&form=10-K (or ?cik=320193). Flat $0.01 per response across 10-K / 10-Q / 8-K. Phase-2 forms (4, 13F-HR) accept their aliases but route to /v1/edgar/insider and /v1/edgar/holdings, which return 503 today. Empty result still returns 200 (proof of absence). 4xx/5xx never charge.","x-pricing-policy":{"mode":"flat-per-response","currency":"USD","price":"$0.01","rationale":"v1 ships one flat per-response price covering the submissions-only forms (10-K / 10-Q / 8-K). Form 4 + 13F-HR remain advertised but route to Phase-2 stubs (503).","supported_forms":["10-K","10-Q","8-K"],"deferred_to_phase2":["4","13F-HR"]}},"servers":[{"url":"https://edgar.apitoll.cloud"}],"tags":[{"name":"sec","description":"SEC / EDGAR source"},{"name":"filings","description":"Corporate filings / disclosures"},{"name":"finance","description":"Public-company financial data"},{"name":"regulatory","description":"Regulatory disclosures"},{"name":"apitoll","description":"ApiToll factory family"}],"paths":{"/v1/edgar/filings":{"get":{"operationId":"getEdgarFilings","summary":"Normalized SEC EDGAR filings by ticker or CIK — 10-K, 10-Q, 8-K","description":"Normalized SEC EDGAR filings for one company × one form-class per call. Backed by data.sec.gov submissions. Returns a rich envelope: resolved company, per-item filing metadata (accession, dates, primary doc URL, immutable flag), and form-specific blocks (8-K eightKItems[]). ETag header set; If-None-Match short-circuit returns 304 without spending bucket tokens. Phase-2 forms (4 / 13F-HR) resolve via aliases but route to the 503 stubs at /v1/edgar/insider and /v1/edgar/holdings.","tags":["sec","filings","finance","regulatory"],"x-keywords":["sec","edgar","filings","10-K","10-Q","8-K","cik","ticker","annual report","quarterly report","material event"],"x-use-cases":["Quarterly + annual report monitoring (10-Q / 10-K)","Material-event feed (8-K items, e.g. 2.02 earnings)","Per-issuer filings history scoping by ?since="],"parameters":[{"name":"cik","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{1,10}$"},"description":"XOR with ticker."},{"name":"ticker","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z.\\-]{1,10}$"},"description":"XOR with cik. Case-insensitive."},{"name":"form","in":"query","required":true,"schema":{"type":"string","enum":["10-K","10-Q","8-K"]},"description":"Aliases accepted (see /v1/edgar/forms). Phase-2 aliases (form-4 / insider / 13f / institutional) resolve but route to 503 stubs."},{"name":"since","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"YYYY-MM-DD, <=5y ago."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10},"description":"Per-form ceiling — see /v1/edgar/forms. Out-of-range clamps silently."},{"name":"includeAmendments","in":"query","required":false,"schema":{"type":"boolean","default":true}}],"security":[{"x402":[]}],"x-payment-info":{"protocols":[{"x402":{"version":2,"network":"eip155:8453","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x58BdAD5e654691aC5eD4631758f3d8DA00666B6c","scheme":"exact"}}],"price":{"mode":"flat","currency":"USD","amount":"$0.01"}},"responses":{"200":{"description":"Filings envelope. `form` discriminates the per-item shape. ETag header set; If-None-Match short-circuit returns 304 without spending bucket tokens.","headers":{"ETag":{"schema":{"type":"string"},"description":"sha256 over sorted accession numbers."},"Cache-Control":{"schema":{"type":"string"},"description":"public,max-age=86400 (10-K/10-Q) or public,max-age=900 (8-K)."}},"content":{"application/json":{"schema":{"type":"object","required":["resolved","form","count","items","source","meta"],"properties":{"resolved":{"$ref":"#/components/schemas/ResolvedCompany"},"form":{"type":"string","enum":["10-K","10-Q","8-K"]},"appliedSince":{"type":["string","null"],"format":"date"},"count":{"type":"integer"},"items":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/Filing10K"},{"$ref":"#/components/schemas/Filing10Q"},{"$ref":"#/components/schemas/Filing8K"}],"discriminator":{"propertyName":"form","mapping":{"10-K":"#/components/schemas/Filing10K","10-K/A":"#/components/schemas/Filing10K","10-Q":"#/components/schemas/Filing10Q","10-Q/A":"#/components/schemas/Filing10Q","8-K":"#/components/schemas/Filing8K"}}}},"truncation":{"$ref":"#/components/schemas/Truncation"},"source":{"$ref":"#/components/schemas/EnvelopeSource"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"}}}}}},"304":{"description":"If-None-Match matched current ETag — no body, no bucket spend."},"400":{"description":"Validation failure (invalid_form / invalid_since / cik_xor_ticker_required) — not charged."},"402":{"description":"Payment Required. Sign an x402 payment authorization and retry.","headers":{"Payment-Required":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 challenge."}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"cik_not_found / ticker_not_found — not charged. Body may include did_you_mean[]."},"405":{"description":"Method not allowed — use GET."},"429":{"description":"rate_limited / wallet_quota_exceeded — not charged. Honors Retry-After."},"502":{"description":"SEC upstream unavailable — not charged."},"503":{"description":"Circuit breaker open OR phase-2 form requested (route to /v1/edgar/insider or /v1/edgar/holdings) — not charged."}}}},"/v1/edgar/forms":{"get":{"operationId":"getEdgarForms","summary":"Supported forms, aliases, flat pricing, per-form limit ceilings, phase-2 deferrals.","tags":["sec","filings"],"security":[],"responses":{"200":{"description":"Forms capability JSON"}}}},"/v1/edgar/limits":{"get":{"operationId":"getEdgarLimits","summary":"Live SEC bucket state, per-wallet caps, mapping freshness, per-form freshness SLA.","tags":["sec"],"security":[],"responses":{"200":{"description":"Limits capability JSON"}}}},"/v1/edgar/insider":{"get":{"operationId":"getEdgarInsider","summary":"Phase-2 stub — Form 4 insider transactions. Currently returns 503.","tags":["sec","filings"],"security":[],"responses":{"503":{"description":"not_yet_available — Phase 2 endpoint."}}}},"/v1/edgar/holdings":{"get":{"operationId":"getEdgarHoldings","summary":"Phase-2 stub — 13F-HR institutional holdings. Currently returns 503.","tags":["sec","filings"],"security":[],"responses":{"503":{"description":"not_yet_available — Phase 2 endpoint."}}}}},"components":{"securitySchemes":{"x402":{"type":"apiKey","in":"header","name":"X-PAYMENT","description":"x402 v2 payment header. Flat $0.01 per response (10-K / 10-Q / 8-K). USDC on eip155:8453."}},"schemas":{"ResolvedCompany":{"type":"object","properties":{"cik":{"type":"string"},"cikInt":{"type":"integer"},"ticker":{"type":["string","null"]},"companyName":{"type":"string"},"entityType":{"type":["string","null"]},"sic":{"type":["string","null"]},"tickerSnapshotDate":{"type":"string","format":"date"},"mappingAgeSeconds":{"type":"integer"}}},"Truncation":{"type":["object","null"],"properties":{"reason":{"type":"string","enum":["limit-clamp","partial-parse-failure","window-edge"]},"nextSince":{"type":"string","format":"date"},"droppedAccessions":{"type":"array","items":{"type":"string"}}}},"EnvelopeSource":{"type":"object","properties":{"name":{"type":"string","enum":["data.sec.gov"]},"fetchedAt":{"type":"string","format":"date-time"},"servedFromCache":{"type":"boolean"},"sourceLastFetchedAt":{"type":"string","format":"date-time"}}},"EnvelopeMeta":{"type":"object","properties":{"relatedEndpoints":{"type":"array","items":{"type":"object","properties":{"rel":{"type":"string"},"href":{"type":"string"},"status":{"type":"integer"}}}}}},"Filing10K":{"type":"object","required":["cik","accessionNumber","form","filingDate","filingUrl","immutable"],"properties":{"form":{"type":"string","enum":["10-K","10-K/A"]},"cik":{"type":"string","description":"10-digit zero-padded CIK."},"accessionNumber":{"type":"string","example":"0000320193-24-000123"},"accessionStripped":{"type":"string","example":"000032019324000123"},"isAmendment":{"type":"boolean"},"filerName":{"type":"string"},"filingDate":{"type":"string","format":"date"},"reportDate":{"type":["string","null"],"format":"date"},"acceptanceDateTime":{"type":["string","null"],"format":"date-time"},"fileNumber":{"type":["string","null"]},"primaryDocument":{"type":["string","null"]},"primaryDocDescription":{"type":["string","null"]},"isXBRL":{"type":"boolean"},"isInlineXBRL":{"type":"boolean"},"size":{"type":["integer","null"]},"filingUrl":{"type":"string","format":"uri"},"filingIndexUrl":{"type":"string","format":"uri"},"filingDirUrl":{"type":"string","format":"uri"},"immutable":{"type":"boolean","description":"True for filings older than 30 days."}}},"Filing10Q":{"type":"object","required":["cik","accessionNumber","form","filingDate","filingUrl","immutable"],"properties":{"form":{"type":"string","enum":["10-Q","10-Q/A"]},"cik":{"type":"string","description":"10-digit zero-padded CIK."},"accessionNumber":{"type":"string","example":"0000320193-24-000123"},"accessionStripped":{"type":"string","example":"000032019324000123"},"isAmendment":{"type":"boolean"},"filerName":{"type":"string"},"filingDate":{"type":"string","format":"date"},"reportDate":{"type":["string","null"],"format":"date"},"acceptanceDateTime":{"type":["string","null"],"format":"date-time"},"fileNumber":{"type":["string","null"]},"primaryDocument":{"type":["string","null"]},"primaryDocDescription":{"type":["string","null"]},"isXBRL":{"type":"boolean"},"isInlineXBRL":{"type":"boolean"},"size":{"type":["integer","null"]},"filingUrl":{"type":"string","format":"uri"},"filingIndexUrl":{"type":"string","format":"uri"},"filingDirUrl":{"type":"string","format":"uri"},"immutable":{"type":"boolean","description":"True for filings older than 30 days."}}},"Filing8K":{"type":"object","required":["cik","accessionNumber","form","filingDate","filingUrl","immutable"],"properties":{"form":{"type":"string","enum":["8-K"]},"cik":{"type":"string","description":"10-digit zero-padded CIK."},"accessionNumber":{"type":"string","example":"0000320193-24-000123"},"accessionStripped":{"type":"string","example":"000032019324000123"},"isAmendment":{"type":"boolean"},"filerName":{"type":"string"},"filingDate":{"type":"string","format":"date"},"reportDate":{"type":["string","null"],"format":"date"},"acceptanceDateTime":{"type":["string","null"],"format":"date-time"},"fileNumber":{"type":["string","null"]},"primaryDocument":{"type":["string","null"]},"primaryDocDescription":{"type":["string","null"]},"isXBRL":{"type":"boolean"},"isInlineXBRL":{"type":"boolean"},"size":{"type":["integer","null"]},"filingUrl":{"type":"string","format":"uri"},"filingIndexUrl":{"type":"string","format":"uri"},"filingDirUrl":{"type":"string","format":"uri"},"immutable":{"type":"boolean","description":"True for filings older than 30 days."},"eightKItems":{"type":"array","description":"Renamed from `items[]` to avoid envelope collision.","items":{"type":"object","properties":{"code":{"type":"string","example":"2.02"},"title":{"type":"string","example":"Results of Operations and Financial Condition"}}}}}}}}}