{"uid":"cap_x9-cfjIIw7tOCapmroVZ4","slug":"financial-datasets-ai-balance-sheets-16e58eff","name":"Financial Datasets AI – Balance Sheets","description":"Balance sheets for a company by ticker or CIK, standardized from SEC filings: assets, liabilities, equity, cash, debt and their main line items. Period annual, quarterly or ttm; filter by report_period or filing_date. Use when an agent needs assets, debt, cash or equity as reported. Non-Professional use; Professional use needs a plan at financialdatasets.ai.","url":"https://api.financialdatasets.ai/financials/balance-sheets?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["period"],"properties":{"cik":{"type":"string","description":"The Central Index Key (CIK) of the company."},"limit":{"type":"integer","description":"The maximum number of balance sheets to return This is the total across all pages, not a page size: each page holds up to 10 records, linked"},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous response's next_page_url."},"period":{"enum":["annual","quarterly","ttm"],"type":"string","description":"The time period of the balance sheets."},"ticker":{"type":"string","description":"The ticker symbol."},"filing_date":{"type":"string","description":"Filter by exact SEC filing date in YYYY-MM-DD format."},"report_period":{"type":"string","description":"Filter by exact report period date in YYYY-MM-DD format."},"filing_date_gt":{"type":"string","description":"Filter by SEC filing date greater than date in YYYY-MM-DD format."},"filing_date_lt":{"type":"string","description":"Filter by SEC filing date less than date in YYYY-MM-DD format."},"filing_date_gte":{"type":"string","description":"Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format."},"filing_date_lte":{"type":"string","description":"Filter by SEC filing date less than or equal to date in YYYY-MM-DD format."},"report_period_gt":{"type":"string","description":"Filter by report period greater than date in YYYY-MM-DD format."},"report_period_lt":{"type":"string","description":"Filter by report period less than date in YYYY-MM-DD format."},"report_period_gte":{"type":"string","description":"Filter by report period greater than or equal to date in YYYY-MM-DD format."},"report_period_lte":{"type":"string","description":"Filter by report period less than or equal to date in YYYY-MM-DD format."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OHHqpHxZzConVDXjFUoKG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns standardized balance sheet data (assets, liabilities, equity, cash, debt) for a US-listed company by ticker or CIK, sourced from SEC filings, for annual, quarterly, or TTM periods.","exampleAgentPrompt":"Pull the last 8 quarterly balance sheets for Apple (ticker AAPL) from SEC filings — I need total assets, total liabilities, shareholders equity, and cash.","exampleUseCases":[{"title":"Equity research balance sheet deep dive","prompt":"Get me the annual balance sheets for Microsoft (MSFT) going back 5 years — I want to see how their total assets, long-term debt, and shareholders equity have changed over time."},{"title":"Debt and liquidity screening","prompt":"Pull the most recent quarterly balance sheet for Tesla (TSLA) from their SEC filings — specifically total debt, cash and equivalents, and current liabilities so I can assess their liquidity position."},{"title":"Fundamental valuation data pull","prompt":"I need the trailing twelve month balance sheet for Nvidia (NVDA) — get total assets, total equity, and goodwill so I can run a book value calculation."}],"resultDescription":"A paginated list of balance sheet records, each containing standardized line items including total assets, total liabilities, shareholders equity, cash and equivalents, total debt, long-term debt, current assets, current liabilities, goodwill, retained earnings, and other standard balance sheet fields, along with the report period and SEC filing date. Includes a next_page_url cursor for pagination.","failureModes":["Missing required 'period' parameter returns a 400 validation error","Invalid or unknown ticker/CIK returns an empty result set or 404","Requesting data for a period before a company's SEC filing history returns no records","Exceeding API credit balance or unpaid x402 payment returns a 402 Payment Required","Rate limiting or server errors return 429 or 5xx responses","Invalid date format for filing_date or report_period filters causes a 400 error"],"whenToPreferThis":"Use this endpoint when you need standardized balance sheet line items — assets, liabilities, equity, cash, debt — sourced directly from SEC filings for any US-listed company. Prefer this over income statement or cash flow endpoints when the question is about financial position (what a company owns and owes) rather than performance or cash flow. Choose this over real-time metrics endpoints when you need historical or multi-period data, or when you need the granular line items rather than computed ratios.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T06:44:16.120Z","isFirstParty":false,"canonicalSlug":"financial-datasets-ai-balance-sheets-16e58eff"}