{"uid":"cap_WbJf8kmXUxq27B8z0s2aC","slug":"financial-datasets-balance-sheet-segment-breakdowns-de9586e4","name":"Financial Datasets Balance Sheet Segment Breakdowns","description":"Balance sheet segment breakdowns for a company by ticker or CIK: assets, goodwill and long-lived assets by business segment, as tagged in SEC filings. Period annual or quarterly; filter by report_period. Use when an agent needs assets or goodwill by segment rather than the consolidated total. Non-Professional use; Professional use needs a plan at financialdatasets.ai.","url":"https://api.financialdatasets.ai/financials/balance-sheets/segments?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 periods to return."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous response's next_page_url."},"period":{"enum":["annual","quarterly"],"type":"string","description":"The time period of the data."},"ticker":{"type":"string","description":"The ticker symbol."},"report_period":{"type":"string","description":"Filter by exact report period 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_aEmtFOrq0pPJ4odg2TleT","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 balance sheet segment breakdowns (assets, goodwill, long-lived assets by business segment) for a US company from SEC filings, filterable by ticker/CIK and period.","exampleAgentPrompt":"Pull the annual balance sheet segment breakdown for Apple (ticker AAPL) from financialdatasets.ai — I want to see assets and goodwill broken out by business segment for the most recent 4 annual periods.","exampleUseCases":[{"title":"Segment goodwill analysis for acquisition research","prompt":"Get me the annual goodwill breakdown by business segment for Alphabet (ticker GOOGL) going back to 2020 — I want to see how goodwill is distributed across their divisions each year."},{"title":"Quarterly segment assets for earnings review","prompt":"Show me the quarterly balance sheet segment data for Microsoft (ticker MSFT) for Q1 through Q4 2023 — specifically assets broken down by business segment as reported in their SEC filings."},{"title":"Multi-period segment comparison by CIK","prompt":"Retrieve annual segment-level assets for the company with CIK 0000320193 for all available periods so I can track how their segment asset allocations have shifted over time."}],"resultDescription":"A paginated list of balance sheet segment records, each containing the company identifier, report period, business segment name, and segment-level financial figures (assets, goodwill, long-lived assets) as tagged in SEC filings, plus a next_page_url cursor for pagination.","failureModes":["Missing required 'period' parameter returns a 400 validation error","Neither ticker nor CIK provided may return empty results or error","Invalid ticker symbol returns empty dataset or 404","Date filter misformatted (not YYYY-MM-DD) causes a 400 error","Company has no segment disclosures in SEC filings — returns empty array","Rate limit or unpaid x402 payment returns 402 Payment Required","CIK not matching any known company returns empty results"],"whenToPreferThis":"Choose this endpoint when you need balance sheet data disaggregated by business segment rather than consolidated totals. Use it over the standard balance sheets endpoint when the analysis requires understanding how assets or goodwill are distributed across a company's divisions or reporting segments as disclosed in SEC filings. Prefer this over manual SEC EDGAR parsing when you need structured, normalized segment data with period filtering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-20T12:40:00.521Z","isFirstParty":false,"canonicalSlug":"financial-datasets-balance-sheet-segment-breakdowns-de9586e4"}