Stocks · Reference and fundamentals

Stocks financials income statements

Income statements of a company, newest period first.

GET/v1/stocks/financials/income-statementsstocksFinancialsIncome

API Developer Paginated Dataset: equities

On this page

Example request
Parameters
Response
Example response
Related

Income statements as reported in SEC filings, one row per reporting period, newest first. timeframe selects quarterly (the default), annual or trailing twelve month periods where available. Periods that were restated appear once per filing. Access depends on the financial data entitlement; without it the route answers 503.

Example request

curl -sS --get "https://api.ordermap.si/v1/stocks/financials/income-statements" \
  -H "Authorization: Bearer $ORDERMAP_API_KEY" \
  --data-urlencode symbol=AAPL

const params = new URLSearchParams({
  symbol: "AAPL",
});
const res = await fetch(`https://api.ordermap.si/v1/stocks/financials/income-statements?${params}`, {
  headers: { Authorization: `Bearer ${process.env.ORDERMAP_API_KEY}` },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { data, meta } = await res.json();
console.log(data, meta.coverage);
// Paginated: repeat with cursor_id set to pagination.next_cursor_id until it is null.

Set ORDERMAP_API_KEY to your key. Replace the dates with a recent trading date.

Parameters

6 parameters, 1 required.

Parameter	Type and limits	Description
`symbol`queryrequired	stringat most 11 characterspattern ^[A-Za-z]{1,6}(\.[A-Za-z0-9]{1,4})?$	Ticker symbol, for example AAPL.
`timeframe`queryoptional	stringquarterlyannualtrailing_twelve_monthsdefault quarterly	Reporting period type (default quarterly).
`start_date`queryoptional	stringdate	Inclusive earliest period end date, YYYY-MM-DD.
`end_date`queryoptional	stringdate	Inclusive latest period end date, YYYY-MM-DD.
`limit`queryoptional	integerdefault 20min 1max 1000	Maximum rows to return.
`cursor_id`queryoptional	stringat most 1024 characters	Opaque cursor returned as pagination.next_cursor_id; resumes the same query on the next page.

Response

Status	Meaning	Body
`200`	Successful response.	Schema below
`400`	Invalid, unknown or repeated parameters, or an invalid cursor.	Error object
`401`	Missing or invalid API key.	Error object
`403`	The plan, dataset release or account state does not allow this request.	Error object
`422`	The request is valid but no data exists for it.	Error object
`429`	Rate limit, burst limit or cooldown; wait Retry-After seconds.Retry-After	Error object
`500`	Internal error.	Error object
`503`	Data temporarily unavailable; retry after Retry-After seconds.Retry-After	Error object
`504`	The request timed out.	Error object

Authenticated responses carry the X-RateLimit-* headers (see rate limits); 429 and 503 add Retry-After.

200 response body

dataarray<object>required34 fields inside
- basic_earnings_per_sharenumber | nullrequiredBasic earnings per share in dollars.
- basic_shares_outstandingnumber | nullrequiredWeighted average basic shares outstanding.
- cikstring | nullrequiredSEC central index key.
- consolidated_net_income_lossnumber | nullrequiredConsolidated net income loss.
- cost_of_revenuenumber | nullrequiredCost of revenue.
- depreciation_depletion_amortizationnumber | nullrequiredDepreciation depletion amortization.
- diluted_earnings_per_sharenumber | nullrequiredDiluted earnings per share in dollars.
- diluted_shares_outstandingnumber | nullrequiredWeighted average diluted shares outstanding.
- discontinued_operationsnumber | nullrequiredDiscontinued operations.
- ebitdanumber | nullrequiredEbitda.
- equity_in_affiliatesnumber | nullrequiredEquity in affiliates.
- extraordinary_itemsnumber | nullrequiredExtraordinary items.
- filing_datestring | nulldaterequiredDate of the latest SEC filing that included this period; restated periods carry a later date.
- fiscal_quarterinteger | nullrequiredFiscal quarter, 1 to 4.
- fiscal_yearinteger | nullrequiredFiscal year.
- gross_profitnumber | nullrequiredGross profit.
- income_before_income_taxesnumber | nullrequiredIncome before income taxes.
- income_taxesnumber | nullrequiredIncome taxes.
- interest_expensenumber | nullrequiredInterest expense.
- interest_incomenumber | nullrequiredInterest income.
- net_income_loss_attributable_common_shareholdersnumber | nullrequiredNet income or loss attributable to common shareholders.
- noncontrolling_interestnumber | nullrequiredNoncontrolling interest.
- operating_incomenumber | nullrequiredOperating income.
- other_income_expensenumber | nullrequiredOther income expense.
- other_operating_expensesnumber | nullrequiredOther operating expenses.
- period_endstringdaterequiredLast date of the reporting period.
- preferred_stock_dividends_declarednumber | nullrequiredPreferred stock dividends declared.
- research_developmentnumber | nullrequiredResearch development.
- revenuenumber | nullrequiredRevenue.
- selling_general_administrativenumber | nullrequiredSelling general administrative.
- symbolsarray<string>requiredEvery ticker of the company (several for multiple share classes).
- timeframestring | nullrequiredPeriod type: quarterly, annual or trailing_twelve_months.
- total_operating_expensesnumber | nullrequiredTotal operating expenses.
- total_other_income_expensenumber | nullrequiredTotal other income expense.
metaobjectrequiredMeta object
paginationobjectrequiredPagination object

Example response

{
  "data": [
    {
      "basic_earnings_per_share": null,
      "basic_shares_outstanding": null,
      "cik": "0000320193",
      "consolidated_net_income_loss": null,
      "cost_of_revenue": null,
      "depreciation_depletion_amortization": null,
      "diluted_earnings_per_share": 1.4,
      "diluted_shares_outstanding": null,
      "discontinued_operations": null,
      "ebitda": null,
      "equity_in_affiliates": null,
      "extraordinary_items": null,
      "filing_date": "2026-08-01",
      "fiscal_quarter": 3,
      "fiscal_year": 2026,
      "gross_profit": 43000000000,
      "income_before_income_taxes": null,
      "income_taxes": null,
      "interest_expense": null,
      "interest_income": null,
      "net_income_loss_attributable_common_shareholders": null,
      "noncontrolling_interest": null,
      "operating_income": 29000000000,
      "other_income_expense": null,
      "other_operating_expenses": null,
      "period_end": "2026-06-27",
      "preferred_stock_dividends_declared": null,
      "research_development": null,
      "revenue": 94000000000,
      "selling_general_administrative": null,
      "symbols": [
        "AAPL"
      ],
      "timeframe": "quarterly",
      "total_operating_expenses": null,
      "total_other_income_expense": null
    }
  ],
  "meta": {
    "as_of": 1760659200123,
    "coverage": {
      "complete": true
    },
    "delay_ms": 0,
    "delayed": false,
    "request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
    "source": "sip"
  },
  "pagination": {
    "count": 1,
    "has_more": false,
    "limit": 20,
    "next_cursor_id": null,
    "next_url": null
  }
}

Values are illustrative. Missing values are null, never 0.

Export this endpointWrite the whole result to a file in the background

Example request

Parameters

Response

200 response body

Example response

Related