All APIs

EPS API for earnings and dividends per share

Get earnings per share, dividends per share and shares outstanding for the company's primary common class.

First request

Quickstart →
curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials?statement=per_share" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
Example response Illustrative response · not a live request
{
  "id": "usa:0000789019",
  "currency": "USD",
  "annual": [
    {
      "fy": 2026,
      "end": "2026-06-30",
      "eps_basic": "18.00",
      "eps_diluted": "17.95"
    }
  ]
}

Endpoints

GETGet standardised company financial statements/v1/companies/{company_id}/financials

Per-share figures and share counts

Earnings per share

EPS figures refer to the primary common class.

Dividends per share

Dividend amounts also refer to the company's primary common class.

Shares outstanding

Share counts follow the same primary common class basis.

Coverage: US, Japan, Korea, EU/EEA, the UK and Taiwan; US history from 2009.

Response fields

eps_basic
Profit or loss per share of the primary common share class, calculated using basic weighted average shares.
eps_diluted
Profit or loss per share of the primary common share class after allowing for dilutive potential common shares.
dividend_per_share
Dividends declared for each share of the primary common share class.
shares_outstanding
The number of shares outstanding in the primary common share class, excluding treasury shares.
weighted_shares_basic
The weighted average number of common shares outstanding during the period used to calculate basic earnings per share.
weighted_shares_diluted
The weighted average number of common shares used to calculate diluted earnings per share, including dilutive potential common shares.

Explore related pages

Income statement API for company earnings

Revenue, costs and profit from company filings

Explore the API →

Balance sheet API for company financial position

Assets, liabilities, equity and derived balance sheet items

Explore the API →

Cash flow statement API for company cash movements

Operating, investing and financing cash flows with signed outflows

Explore the API →

Financial statements API for company analysis

Standardised statements, reporting periods and historical versions

Explore the API →

Common questions

Do these figures cover every share class?

EPS, dividends per share and shares outstanding refer to the primary common class.

Does a missing dividend figure mean zero?

A missing dividend item is omitted rather than filled with zero. A reported zero is returned as zero.

Do I need a paid plan for per-share items?

The 77 standard items, including per-share and share count items, are available on every plan. Plans determine history and delivery timing.