Skip to content
Clear Street Clear Street
Get started
API Reference
V1
Instrument Data

Get Instrument Income Statements

InstrumentDataGetInstrumentIncomeStatementsResponse v1().instrumentData().getInstrumentIncomeStatements(InstrumentDataGetInstrumentIncomeStatementsParamsparams = InstrumentDataGetInstrumentIncomeStatementsParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/instruments/{instrument_id}/income-statements

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)
ParametersExpand Collapse
InstrumentDataGetInstrumentIncomeStatementsParams params
Optional<String> instrumentId

OEMS instrument UUID

formatuuid
Optional<String> fromDate

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

Optional<Long> pageSize

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

formatint64
maximum1000
minimum1
Optional<String> pageToken

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

formatbyte
Optional<String> toDate

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

ReturnsExpand Collapse
class InstrumentDataGetInstrumentIncomeStatementsResponse:
LocalDateTime acceptedDate

The date and time when the filing was accepted by the SEC

formatdate-time
LocalDate filingDate

The date the financial statement was filed

formatdate
String period

The fiscal period identifier (e.g., “Q1”, “Q2”, “Q3”, “Q4”)

FiscalPeriodType periodType

The type of fiscal period

One of the following:
QUARTERLY("QUARTERLY")
ANNUAL("ANNUAL")
TTM("TTM")
BIANNUAL("BIANNUAL")
String reportedCurrency

The currency in which the statement is reported (ISO 4217)

long year

The fiscal year of the statement

formatint32
Optional<String> bottomLineNetIncome

Bottom line net income after all adjustments

Optional<String> costAndExpenses

Total costs and expenses

Optional<String> costOfRevenue

Direct costs attributable to producing goods sold

Optional<String> depreciationAndAmortization

Depreciation and amortization expenses

Optional<String> ebit

Earnings before interest and taxes

Optional<String> ebitda

Earnings before interest, taxes, depreciation, and amortization

Optional<String> eps

Basic earnings per share

Optional<String> epsDiluted

Diluted earnings per share

Optional<String> generalAndAdministrativeExpenses

General administrative overhead expenses

Optional<String> grossProfit

Revenue minus cost of revenue

Optional<String> incomeBeforeTax

Income before income tax expense

Optional<String> incomeTaxExpense

Income tax expense for the period

Optional<String> interestExpense

Interest paid on debt

Optional<String> interestIncome

Interest earned on investments and cash

Optional<String> netIncome

Total net income for the period

Optional<String> netIncomeDeductions

Deductions from net income

Optional<String> netIncomeFromContinuingOperations

Net income from continuing operations

Optional<String> netIncomeFromDiscontinuedOperations

Net income from discontinued operations

Optional<String> netInterestIncome

Net interest income (interest income minus interest expense)

Optional<String> nonOperatingIncomeExcludingInterest

Non-operating income excluding interest

Optional<String> operatingExpenses

Total operating expenses

Optional<String> operatingIncome

Income from core business operations

Optional<String> otherAdjustmentsToNetIncome

Other adjustments to net income

Optional<String> otherExpenses

Other miscellaneous expenses

Optional<String> researchAndDevelopmentExpenses

Expenditure on research and development activities

Optional<String> revenue

Total revenue from sales of goods and services

Optional<String> sellingAndMarketingExpenses

Expenditure on marketing and sales activities

Optional<String> sellingGeneralAndAdministrativeExpenses

Combined selling, general, and administrative expenses

Optional<String> totalOtherIncomeExpensesNet

Net of other income and expenses

Optional<String> weightedAverageShsOut

Weighted average shares outstanding (basic)

Optional<String> weightedAverageShsOutDil

Weighted average shares outstanding (diluted)

Get Instrument Income Statements

package com.clear_street.api.example;

import com.clear_street.api.client.ClearStreetClient;
import com.clear_street.api.client.okhttp.ClearStreetOkHttpClient;
import com.clear_street.api.models.v1.instrumentdata.InstrumentDataGetInstrumentIncomeStatementsParams;
import com.clear_street.api.models.v1.instrumentdata.InstrumentDataGetInstrumentIncomeStatementsResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        ClearStreetClient client = ClearStreetOkHttpClient.builder()
            .fromEnv()
            .apiKey("My API Key")
            .build();

        InstrumentDataGetInstrumentIncomeStatementsResponse response = client.v1().instrumentData().getInstrumentIncomeStatements("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e");
    }
}
{
  "data": [
    {
      "accepted_date": "2025-05-02T14:30:00Z",
      "cost_of_revenue": "52080000000",
      "eps": "1.40",
      "eps_diluted": "1.38",
      "filing_date": "2025-05-01",
      "gross_profit": "42850000000",
      "net_income": "22200000000",
      "operating_income": "26550000000",
      "period": "Q1",
      "period_type": "QUARTERLY",
      "reported_currency": "USD",
      "revenue": "94930000000",
      "year": 2025
    }
  ],
  "error": null,
  "metadata": {
    "next_page_token": "AAAAAAAAAGQAAAAAAAAAZQ==",
    "page_number": 1,
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "total_items": 20,
    "total_pages": 2
  }
}
{
  "error": {
    "code": 404,
    "message": "Instrument not found: AAP"
  },
  "metadata": {
    "request_id": "fa8cc9b2-fbf0-4f5b-8ce3-b3205b9f85f2"
  }
}
Returns Examples
{
  "data": [
    {
      "accepted_date": "2025-05-02T14:30:00Z",
      "cost_of_revenue": "52080000000",
      "eps": "1.40",
      "eps_diluted": "1.38",
      "filing_date": "2025-05-01",
      "gross_profit": "42850000000",
      "net_income": "22200000000",
      "operating_income": "26550000000",
      "period": "Q1",
      "period_type": "QUARTERLY",
      "reported_currency": "USD",
      "revenue": "94930000000",
      "year": 2025
    }
  ],
  "error": null,
  "metadata": {
    "next_page_token": "AAAAAAAAAGQAAAAAAAAAZQ==",
    "page_number": 1,
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "total_items": 20,
    "total_pages": 2
  }
}
{
  "error": {
    "code": 404,
    "message": "Instrument not found: AAP"
  },
  "metadata": {
    "request_id": "fa8cc9b2-fbf0-4f5b-8ce3-b3205b9f85f2"
  }
}