## 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)

### Parameters

- `InstrumentDataGetInstrumentIncomeStatementsParams params`

  - `Optional<String> instrumentId`

    OEMS instrument UUID

  - `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.

  - `Optional<String> pageToken`

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

  - `Optional<String> toDate`

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

### Returns

- `class InstrumentDataGetInstrumentIncomeStatementsResponse:`

  - `List<InstrumentIncomeStatement> data`

    - `LocalDateTime acceptedDate`

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

    - `LocalDate filingDate`

      The date the financial statement was filed

    - `String period`

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

    - `FiscalPeriodType periodType`

      The type of fiscal period

      - `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

    - `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)

### Example

```java
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");
    }
}
```

#### Response

```json
{
  "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
  }
}
```