# Financial Datasets AI – Income Statements

> Financial Datasets AI – Income Statements is a paid API for AI agents from api.financialdatasets.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-27).

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.

## Facts

- Endpoint: GET https://api.financialdatasets.ai/financials/income-statements?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/financial-datasets-ai-income-statements-329432cc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__1BjH3Wo1pJNletbreBb-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability financial-datasets-ai-income-statements-329432cc
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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 e
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/financial-datasets-ai-income-statements-329432cc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.financialdatasets.ai](https://www.zero.xyz/host/api.financialdatasets.ai/llms.txt)