{"uid":"cap_Lcp0Kmi7wLu2KKsLmMN_6","slug":"tbs-sec-filings-api-resolve-cb3578d6","name":"TBS SEC Filings API – Resolve","description":"SEC EDGAR data for AI agents in one sub-cent call: resolve a ticker or company name to its CIK, list recent filings (10-K, 10-Q, 8-K) with direct document URLs, and pull XBRL financial facts (revenue, net income, assets, EPS). Keyless, unified schema, USDC-payable via x402 on Base.","url":"https://sec-x402.tbs-digital.com/sec/resolve?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"name":{"type":"string","description":"Company name, e.g. Apple (partial match)"},"ticker":{"type":"string","description":"Stock ticker, e.g. AAPL, NVDA"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"payer":{"type":"object","properties":{"address":{"type":"string","nullable":true},"network":{"type":"string"}}},"source":{"type":"string"},"company":{"type":"object"},"request_id":{"type":"string"},"generated_at":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"payer":{"address":"0x0000000000000000000000000000000000000000","network":"base"},"source":"sec-edgar","company":{"cik":"0000320193","title":"Apple Inc.","ticker":"AAPL"},"request_id":"0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55","generated_at":"2026-08-11T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WkC2tOYDYNjdZreWWsXK7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a stock ticker or company name to its SEC EDGAR CIK identifier, returning core company metadata in a unified schema.","exampleAgentPrompt":"What's the SEC EDGAR CIK for Nvidia — look it up by its ticker NVDA and give me the company name and identifier so I can pull its filings next.","exampleUseCases":[{"title":"Equity research CIK bootstrap","prompt":"I'm starting research on Apple — can you resolve its ticker AAPL to its SEC EDGAR CIK so I know which entity to pull 10-K and 10-Q filings from?"},{"title":"Validate company SEC identity before filing analysis","prompt":"Before I pull any financial documents, can you confirm that the SEC EDGAR entity for 'Alphabet' is actually registered under GOOGL and tell me its CIK number?"},{"title":"Build a watchlist of SEC entity IDs","prompt":"I need the SEC CIK numbers for these companies — look up Microsoft by ticker MSFT and give me back the official company name and CIK so I can track their filings."}],"resultDescription":"Returns a JSON object containing the resolved company's CIK (e.g. '0000320193'), official SEC title (e.g. 'Apple Inc.'), ticker symbol, plus request metadata including a unique request_id, generated_at timestamp, data source label ('sec-edgar'), and payer wallet address and network for x402 billing.","failureModes":["Ambiguous or misspelled company name returns no match or wrong entity","Ticker not found in EDGAR returns empty or error response","Invalid query parameter type causes 400-level error","Network or payment authorization failure via x402 results in 402 Payment Required","Rate limiting or upstream EDGAR outage causes timeout or 5xx error"],"whenToPreferThis":"Use this endpoint when you need to resolve a human-readable company name or stock ticker to a canonical SEC CIK before querying filings or financial facts. Prefer it over manual EDGAR search when building automated pipelines that need a fast, sub-cent, keyless resolution step with a unified JSON schema payable in USDC on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T12:36:42.939Z","isFirstParty":false,"canonicalSlug":"tbs-sec-filings-api-resolve-cb3578d6"}