> ## Documentation Index > Fetch the complete documentation index at: https://tradewatch.io/docs/llms.txt > Use this file to discover all available pages before exploring further. # Income Statements > Returns income statement data sourced from SEC EDGAR filings. Each record covers one reporting period and includes revenue, profitability, and per-share metrics. Use `period=annual` for 10-K data or `period=quarterly` for 10-Q data. Results are ordered by `report_date` descending. ## OpenAPI ````yaml /openapi.json get /stocks/income-statements openapi: 3.1.0 info: title: tradewatch.io version: 3.1.0 description: Financial market data for Developers servers: - url: https://api.tradewatch.io description: Production API server security: - API Key: [] tags: - name: Account description: >- In this section, you can find methods that can be helpful to manage your API account. x-displayName: Account - name: Currencies description: >- In this section, you can find methods that can be helpful to retrieve data for traditional currencies (Forex). x-displayName: Currencies - name: Crypto description: >- In this section, you can find methods that can be helpful to retrieve data for cryptocurrencies. x-displayName: Crypto - name: Indices description: >- In this section, you can find methods that can be helpful to retrieve data for market indices. x-displayName: Indices - name: Stocks description: >- In this section, you can find methods that can be helpful to retrieve data for stocks and equities. x-displayName: Stocks - name: Fundamentals description: Financial statements and company data sourced from SEC EDGAR filings. - name: Markets description: Stock exchange and market session information. - name: Commodities description: >- In this section, you can find methods that can be helpful to retrieve data for commodities. x-displayName: Commodities paths: /stocks/income-statements: get: tags: - Fundamentals summary: Income Statements description: >- Returns income statement data sourced from SEC EDGAR filings. Each record covers one reporting period and includes revenue, profitability, and per-share metrics. Use `period=annual` for 10-K data or `period=quarterly` for 10-Q data. Results are ordered by `report_date` descending. operationId: list_income_statements_income_statements_get parameters: - name: ticker in: query required: true schema: type: string description: Stock ticker symbol (e.g. AAPL) title: Ticker description: Stock ticker symbol (e.g. AAPL) - name: period in: query required: true schema: type: string description: 'Reporting period: `annual` (10-K) or `quarterly` (10-Q)' title: Period description: 'Reporting period: `annual` (10-K) or `quarterly` (10-Q)' - name: limit in: query required: false schema: anyOf: - type: integer maximum: 100 minimum: 1 - type: 'null' description: Maximum number of records to return (1–100) title: Limit description: Maximum number of records to return (1–100) - name: report_date in: query required: false schema: anyOf: - type: string format: date - type: 'null' description: Filter by exact report date (YYYY-MM-DD) title: Report Date description: Filter by exact report date (YYYY-MM-DD) - name: report_date_gte in: query required: false schema: anyOf: - type: string format: date - type: 'null' description: 'Filter: report_date >= this date (YYYY-MM-DD)' title: Report Date Gte description: 'Filter: report_date >= this date (YYYY-MM-DD)' - name: report_date_lte in: query required: false schema: anyOf: - type: string format: date - type: 'null' description: 'Filter: report_date <= this date (YYYY-MM-DD)' title: Report Date Lte description: 'Filter: report_date <= this date (YYYY-MM-DD)' - name: report_date_gt in: query required: false schema: anyOf: - type: string format: date - type: 'null' description: 'Filter: report_date > this date (YYYY-MM-DD)' title: Report Date Gt description: 'Filter: report_date > this date (YYYY-MM-DD)' - name: report_date_lt in: query required: false schema: anyOf: - type: string format: date - type: 'null' description: 'Filter: report_date < this date (YYYY-MM-DD)' title: Report Date Lt description: 'Filter: report_date < this date (YYYY-MM-DD)' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/IncomeStatementsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: IncomeStatementsResponse: properties: ticker: type: string title: Ticker description: Stock ticker symbol (uppercase) period: type: string title: Period description: 'Reporting period type: ''annual'' or ''quarterly''' income_statements: items: $ref: '#/components/schemas/IncomeStatementItem' type: array title: Income Statements description: List of income statement records ordered by report date descending type: object required: - ticker - period - income_statements title: IncomeStatementsResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError IncomeStatementItem: properties: report_date: type: string format: date title: Report Date description: End date of the reporting period (YYYY-MM-DD) filing_type: anyOf: - type: string - type: 'null' title: Filing Type description: SEC filing type, e.g. 10-K (annual) or 10-Q (quarterly) revenue: anyOf: - type: number - type: 'null' title: Revenue description: Total revenue (USD) cost_of_revenue: anyOf: - type: number - type: 'null' title: Cost Of Revenue description: Cost of goods sold / cost of revenue (USD) gross_profit: anyOf: - type: number - type: 'null' title: Gross Profit description: Revenue minus cost of revenue (USD) operating_expenses: anyOf: - type: number - type: 'null' title: Operating Expenses description: Total operating expenses excluding cost of revenue (USD) operating_income: anyOf: - type: number - type: 'null' title: Operating Income description: Gross profit minus operating expenses (USD) net_income: anyOf: - type: number - type: 'null' title: Net Income description: Net income attributable to the company (USD) eps: anyOf: - type: number - type: 'null' title: Eps description: Basic earnings per share (USD) eps_diluted: anyOf: - type: number - type: 'null' title: Eps Diluted description: >- Diluted earnings per share, accounting for stock options and convertibles (USD) weighted_average_shares: anyOf: - type: number - type: 'null' title: Weighted Average Shares description: Weighted average basic shares outstanding used for EPS calculation weighted_average_shares_diluted: anyOf: - type: number - type: 'null' title: Weighted Average Shares Diluted description: >- Weighted average diluted shares outstanding used for diluted EPS calculation type: object required: - report_date title: IncomeStatementItem ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: API Key: description: Authentication via API key header type: apiKey name: api-key in: header ````