Equity Income Statement

GET/gateway/v1/equity/income-statement

Returns paginated standardized income-statement periods for a US-listed equity. The API passes through available periods and does not synthesize missing periods or financial values.

Query Parameters

symbolstringrequired

US equity ticker symbol

Example: AAPL

periodenum<string>

Financial period

Available options:quarterlyytdannualttm

end_datestring

Inclusive latest period end date in YYYY-MM-DD format

Example: 2024-12-31

limitinteger

Maximum financial periods to return

Equity Income Statement

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/equity/income-statement?symbol=AAPL&end_date=2024-12-31', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseEquityIncomeStatementItem.json",
  "data": [
    {
      "calculated_at": 123,
      "cost_of_revenue": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "currency": "<string>",
      "dividends_per_common_share": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "ebit": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "ebitda": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "eps_basic": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "eps_calculation_method": "<string>",
      "eps_diluted": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "fiscal_period": "<string>",
      "fiscal_quarter": 123,
      "fiscal_year": 123,
      "formula_version": "<string>",
      "gross_profit": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "income_tax_expense": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "interest_expense": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "net_income": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "net_income_common_stock": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "net_income_discontinued_operations": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "net_income_non_controlling_interests": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "net_income_yoy": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "operating_expense": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "operating_income": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "operating_income_yoy": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "period": "<string>",
      "report_period": "<string>",
      "research_and_development": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "revenue": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "revenue_yoy": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "sga_expense": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "source_updated_at": 123,
      "symbol": "<string>",
      "total_operating_costs": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "weighted_average_shares": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "weighted_average_shares_diluted": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      }
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}