{"uid":"cap_qUaepA5zREY7Av6nC_K2K","slug":"sec-xbrl-financials-endpoint-e5c5174d","name":"SEC XBRL Financials Endpoint","description":"Headline annual financials for a US public company from XBRL: revenue, profit, assets, debt-to-assets, cash flow, flags.","url":"https://company-enrichment.x402tookit.com/sec-financials?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","required":["id"],"properties":{"id":{"type":"string","description":"Ticker or CIK"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"cik":{"type":["null","number"]},"asOf":{"type":["null","string"]},"cash":{"type":["null","number"]},"source":{"type":["null","string"]},"company":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"revenue":{"type":["null","number"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"tagsUsed":{"type":["null","object"],"properties":{"cash":{"type":["null","string"]},"assets":{"type":["null","string"]},"equity":{"type":["null","string"]},"revenue":{"type":["null","string"]},"netIncome":{"type":["null","string"]},"liabilities":{"type":["null","string"]},"operatingCashFlow":{"type":["null","string"]}}},"netIncome":{"type":["null","number"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"thresholds":{"type":["null","object"],"properties":{"highLiabilitiesToAssets":{"type":["null","number"]}}},"totalAssets":{"type":["null","number"]},"netMarginPct":{"type":["null","number"]},"revenueGrowthPct":{"type":["null","number"]},"totalLiabilities":{"type":["null","number"]},"operatingCashFlow":{"type":["null","number"]},"shareholdersEquity":{"type":["null","number"]},"latestFiscalYearEnd":{"type":["null","string"]},"liabilitiesToAssets":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3ePqC9rZwMmNWRnw_vnoB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns headline annual financial metrics for a US public company from SEC XBRL data: revenue, net income, assets, liabilities, cash flow, and financial health flags.","exampleAgentPrompt":"Pull the headline annual financials for Tesla from SEC XBRL data — I want revenue, net income, total assets, debt-to-assets ratio, operating cash flow, and any financial health flags.","exampleUseCases":[{"title":"Pre-investment financial screen","prompt":"Before I consider investing in Apple, can you pull its latest SEC XBRL annual financials — revenue, profit, debt levels, and cash flow — and flag anything that looks concerning?"},{"title":"Competitor financial benchmarking","prompt":"I need to compare the financial health of Ford and GM side by side — can you pull the headline annual financials for both tickers from SEC data, including revenue, net margin, and liabilities-to-assets ratio?"},{"title":"Automated portfolio health check","prompt":"For each company in my watchlist starting with ticker INTC, grab the latest SEC XBRL financials and tell me if there are any red flags around high debt, negative cash flow, or shrinking revenue."}],"resultDescription":"Returns a JSON object with the company name, CIK, fiscal year end date, and headline financials: revenue, net income, total assets, total liabilities, shareholders equity, operating cash flow, cash, liabilities-to-assets ratio, net margin percentage, and revenue growth percentage. Also includes a verdict string, list of red-flag reasons, a plain-English summary, degraded-data flag, XBRL tags used for each metric, source URL, and disclaimer.","failureModes":["Unknown ticker or CIK returns null fields or empty response","Company has incomplete XBRL data resulting in degraded=true and some null fields","Non-US or non-public company not found in SEC EDGAR","Rate limiting or payment failure with x402 protocol returns 402 status","Very recent filings not yet indexed return stale or prior-year data"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable annual financial metrics for a US public company derived directly from SEC XBRL filings. It is ideal for financial screening, due diligence, or portfolio monitoring workflows where you want standardized balance sheet, income statement, and cash flow figures with built-in health flags, rather than parsing raw SEC filings yourself or using a paid financial data provider.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T00:21:41.574Z","isFirstParty":false,"canonicalSlug":"sec-xbrl-financials-endpoint-e5c5174d"}