{"uid":"cap_1fzPBuAgy0UmF1vf2u6o0","slug":"stablefinance-income-statements-api-d2b078fe","name":"StableFinance Income Statements API","description":"Normalized income statements. Invalid or unsupported tickers return upstream 400/404; check /api/company/facts/tickers or endpoint-specific /tickers lists before batching.","url":"https://stablefinance.dev/api/financials/income-statements","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","$schema":"https://json-schema.org/draft/2020-12/schema","required":["period"],"properties":{"cik":{"type":"string","minLength":1},"limit":{"type":"integer","maximum":50,"minimum":1},"period":{"enum":["annual","quarterly","ttm"],"type":"string"},"ticker":{"type":"string","minLength":1},"report_period":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_gt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_lt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_gte":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_lte":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["income_statements"],"properties":{"income_statements":{"type":"array","items":{}}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"income_statements":[{"period":"annual","ticker":"AAPL","revenue":391035000000,"currency":"USD","net_income":93736000000,"gross_profit":180683000000,"fiscal_period":"FY2024","report_period":"2024-09-28","operating_income":123216000000,"earnings_per_share":6.11,"earnings_per_share_diluted":6.08}]}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":5,"period":"annual","ticker":"AAPL"}},"output":{"type":"json","example":{"income_statements":[]}}},"response":{"income_statements":[{"ebit":132729000000,"period":"annual","ticker":"AAPL","revenue":416161000000,"currency":"USD","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm","net_income":112010000000,"gross_profit":195201000000,"fiscal_period":"FY2025","report_period":"2025-09-27","cost_of_revenue":220960000000,"accession_number":"0000320193-25-000079","interest_expense":null,"operating_income":133050000000,"operating_expense":62151000000,"earnings_per_share":7.49,"income_tax_expense":20719000000,"consolidated_income":112010000000,"net_income_common_stock":112010000000,"weighted_average_shares":14948500000,"research_and_development":34550000000,"dividends_per_common_share":1.02,"earnings_per_share_diluted":7.46,"preferred_dividends_impact":0,"nonoperating_income_expense":-321000000,"weighted_average_shares_diluted":15004697000,"net_income_discontinued_operations":null,"net_income_non_controlling_interests":null,"selling_general_and_administrative_expenses":27601000000},{"ebit":123485000000,"period":"annual","ticker":"AAPL","revenue":391035000000,"currency":"USD","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm","net_income":93736000000,"gross_profit":180683000000,"fiscal_period":"FY2024","report_period":"2024-09-28","cost_of_revenue":210352000000,"accession_number":"0000320193-24-000123","interest_expense":null,"operating_income":123216000000,"operating_expense":57467000000,"earnings_per_share":6.11,"income_tax_expense":29749000000,"consolidated_income":93736000000,"net_income_common_stock":93736000000,"weighted_average_shares":15343783000,"research_and_development":31370000000,"dividends_per_common_share":0.98,"earnings_per_share_diluted":6.08,"preferred_dividends_impact":0,"nonoperating_income_expense":269000000,"weighted_average_shares_diluted":15408095000,"net_income_discontinued_operations":null,"net_income_non_controlling_interests":null,"selling_general_and_administrative_expenses":26097000000},{"ebit":113736000000,"period":"annual","ticker":"AAPL","revenue":383285000000,"currency":"USD","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/0000320193-23-000106-index.htm","net_income":96995000000,"gross_profit":169148000000,"fiscal_period":"FY2023","report_period":"2023-09-30","cost_of_revenue":214137000000,"accession_number":"0000320193-23-000106","interest_expense":null,"operating_income":114301000000,"operating_expense":54847000000,"earnings_per_share":6.16,"income_tax_expense":16741000000,"consolidated_income":96995000000,"net_income_common_stock":96995000000,"weighted_average_shares":15744231000,"research_and_development":29915000000,"dividends_per_common_share":0.94,"earnings_per_share_diluted":6.13,"preferred_dividends_impact":0,"nonoperating_income_expense":-565000000,"weighted_average_shares_diluted":15812547000,"net_income_discontinued_operations":null,"net_income_non_controlling_interests":null,"selling_general_and_administrative_expenses":24932000000}]}},"exampleRequest":{"limit":5,"period":"annual","ticker":"AAPL"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_NSYgakY1_0qKU6kuvll68","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":"Retrieves income statement financial data (revenue, net income, EPS, etc.) for publicly traded companies by ticker or CIK, supporting annual, quarterly, and TTM periods.","exampleAgentPrompt":"Pull Apple's annual income statements from Financial Datasets AI for the last 5 years — I want to see revenue, net income, gross profit, operating income, and EPS.","exampleUseCases":null,"resultDescription":"Returns an array of income statement objects for the queried company, each containing ticker, period type (annual/quarterly/ttm), fiscal period label, report date, revenue, gross profit, operating income, net income, EPS (basic and diluted), and currency denomination.","failureModes":["Missing required 'period' parameter returns a validation error","Invalid ticker symbol or CIK returns empty results or 404","Payment not included or insufficient USDC balance returns HTTP 402","report_period filter with wrong date format (not YYYY-MM-DD) returns schema validation error","Limit exceeds 50 returns a validation error","No matching data for the given date range returns empty income_statements array"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable income statement data for a publicly traded company, especially when you want to filter by reporting period, date range, or retrieve multiple periods at once. Prefer this over general financial news APIs when you need precise numerical financial figures like revenue, EPS, or net income for quantitative analysis or LLM-driven financial research.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:48:34.374Z","isFirstParty":false}