Declared dividends for a single instrument

Every dividend an issuer has declared for one instrument, newest first, including one declared but not yet paid. Amounts are reported in the unit the announcement used and are not converted, so read amount.unit alongside every figure: 4.4 with unit: minor and 0.044 with unit: major are the same amount. Where one claim is listed as parallel lines in different currencies, each line returns only its own currency's dividends, even though a single announcement declares them all. Ask for the line you want.

Code samples

curl -X GET 'https://api.tickerapp.net/v2/dividends/<identifier>/history' \
  -H 'x-api-key: $TICKER_API_KEY'

Try it

Try it live

Send a real request to this endpoint with your API key. Sign in to try it from your browser.

Parameters

Path parameters

identifierrequired

string

ISIN (12 chars) or MIC:symbol.

Query parameters

dateFrom

string

Filter by declaration date from this date (partial ISO8601 accepted). Note this is the date the dividend was declared, not the period it relates to — a dividend for one financial year is often declared in the next.

dateTo

string

Filter by declaration date to this date (partial ISO8601 accepted).

pageSize

integer

Number of items per page (default 50, max 200)

Default: 50

pageNumber

integer

Page number (1-indexed). Mutually exclusive with pageCursor.

Responses

200Dividend history for the instrument

{
  "instrument": {
    "isin": string
  },
  "entity": {
    "name": string
  },
  "listing": {
    "symbol": string | null,
    "mic": string
  },
  "data": [DividendRecord],
  "meta": {
    "paging": ClassicPaging
  }
}

403The plan does not include dividend data

404Instrument not found, or it has no recorded dividends