CLclear-street
Instrument Data

Get Instrument Income Statements

Changed on

Retrieves quarterly income statements for a specific instrument, sorted by fiscal period (most recent first).

Date range defaults:

  • from_date: None (no lower bound)
  • to_date: None (no upper bound)

Pagination metadata does not include total_items or total_pages for this endpoint. Use next_page_token to detect whether more results exist.

get/v1/instruments/{instrument_id}/income-statements

Request

  • Base URL
    https://api.clearstreet.com
  • Auth
    HTTP bearer

Path parameters

instrument_idstring required

Instrument identifier: either an instrument UUID or a symbol (symbol for equities, OSI for options). Non-UUID inputs are resolved server-side.

Instrument ID (UUID) or symbol (equity ticker or OSI option symbol).

Query parameters

page_sizeinteger

The number of items to return per page. Only used when page_token is not provided.

page_tokenstring byte

Base64URL-encoded pagination token

Token for retrieving the next or previous page of results. Contains encoded pagination state; when provided, page_size is ignored.

from_datestring

The start date for the query range, inclusive (YYYY-MM-DD).

to_datestring

The end date for the query range, inclusive (YYYY-MM-DD).

Response

List of quarterly income statements

Example response

{
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero"
  },
  "metadata": {
    "page_number": 1,
    "total_items": 42,
    "total_pages": 5
  },
  "data": [
    {
      "accepted_date": "2025-05-02T14:30:00Z",
      "bottom_line_net_income": "22200000000",
      "cost_and_expenses": "68380000000",
      "cost_of_revenue": "52080000000",
      "depreciation_and_amortization": "2800000000",
      "ebit": "26550000000",
      "ebitda": "29350000000",
      "eps": "1.40",
      "eps_diluted": "1.38",
      "filing_date": "2025-05-01",
      "general_and_administrative_expenses": "2500000000",
      "gross_profit": "42850000000",
      "income_before_tax": "26400000000",
      "income_tax_expense": "4200000000",
      "interest_expense": "1450000000",
      "interest_income": "1200000000",
      "net_income": "22200000000",
      "net_income_deductions": null,
      "net_income_from_continuing_operations": "22200000000",
      "net_income_from_discontinued_operations": null,
      "net_interest_income": "-250000000",
      "non_operating_income_excluding_interest": "100000000",
      "operating_expenses": "16300000000",
      "operating_income": "26550000000",
      "other_adjustments_to_net_income": null,
      "other_expenses": "0",
      "period": "Q1",
      "period_type": "QUARTERLY",
      "reported_currency": "USD",
      "research_and_development_expenses": "7700000000",
      "revenue": "94930000000",
      "selling_and_marketing_expenses": "6100000000",
      "selling_general_and_administrative_expenses": "8600000000",
      "total_other_income_expenses_net": "-150000000",
      "weighted_average_shs_out": "15800000000",
      "weighted_average_shs_out_dil": "16000000000",
      "year": 2025
    }
  ]
}

Changes

  • 1bd9eddeffc8Revision changes
    • breaking

      for the path request parameter instrument_id, the minLength was increased from 0 to 1

    • info

      for the path request parameter instrument_id, the type was generalized from no type to string