{"uid":"cap__1BjH3Wo1pJNletbreBb-","slug":"financial-datasets-ai-income-statements-329432cc","name":"Financial Datasets AI – Income Statements","description":"Income statements for a company by ticker or CIK, standardized from SEC filings: revenue, cost of revenue, gross profit, operating expenses, operating income, net income, EPS and shares. Period annual, quarterly or ttm; filter by report_period or filing_date. Use when an agent needs revenue, margins or earnings as reported. Non-Professional use; Professional use needs a plan at financialdatasets.ai.","url":"https://api.financialdatasets.ai/financials/income-statements?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 income statements to return."},"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 income statements."},"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_FPmSjzJWU0z0oBIYeSN7_","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 standardized income statement data (revenue, gross profit, operating income, net income, EPS, shares) for a US-listed company from SEC filings, by ticker or CIK, for annual, quarterly, or TTM periods.","exampleAgentPrompt":"Pull Apple's quarterly income statements for the last 8 quarters from SEC filings — I need revenue, gross profit, operating income, net income, and EPS for each period.","exampleUseCases":[{"title":"Earnings trend analysis for equity research","prompt":"Get me Microsoft's annual income statements for the last 5 years — I want to see revenue, operating income, and net income so I can chart the earnings trend."},{"title":"Margin comparison across recent quarters","prompt":"Fetch NVIDIA's quarterly income statements for the past 4 quarters so I can compare gross margin and operating margin quarter over quarter."},{"title":"Fundamental screening by CIK","prompt":"Pull the TTM income statement for the company with CIK 0000320193 — I need revenue, cost of revenue, and net income as reported in their most recent SEC filing."}],"resultDescription":"Returns a list of standardized income statement records, each containing report period, filing date, revenue, cost of revenue, gross profit, operating expenses, operating income, net income, EPS (basic and diluted), and share counts. Includes pagination cursor for fetching additional pages.","failureModes":["Invalid or unknown ticker symbol returns empty results or 404","Missing required 'period' parameter returns a 400 validation error","CIK not found in SEC database returns empty income_statements array","Filtering by both ticker and an out-of-range date range returns no results","Rate limiting or plan restrictions may return 402 or 429 if non-professional usage limits are exceeded","Pagination cursor mismatch or stale cursor may return an error or unexpected page"],"whenToPreferThis":"Choose this endpoint when you need standardized, SEC-sourced income statement line items (revenue, margins, EPS) for a US-listed public company, especially when you need historical period-by-period data with date filtering. Prefer this over earnings snapshot endpoints when you need the full P&L breakdown rather than just headline EPS/revenue figures, and over financial metrics endpoints when you want the raw reported figures rather than computed ratios.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T12:49:43.618Z","isFirstParty":false,"canonicalSlug":"financial-datasets-ai-income-statements-329432cc"}