Dividend History

Retrieve historical dividend payments including amounts, ex-dividend dates, and payment schedules. Essential for income investment analysis and yield calculations.

Use Case: Calculate dividend growth rate over 10 years to identify dividend aristocrat stocks.

GET /v1/corporate-actions/dividends

Get Dividend History

cURL

curl --request GET \
  --url https://api.aries.com/v1/corporate-actions/dividends \
  --header 'Authorization: Bearer <token>'

200

default

{
  "results": [
    {
      "ticker": "AAPL",
      "cashAmount": 0.26,
      "exDividendDate": "2025-11-10",
      "payDate": "2025-11-13",
      "recordDate": "2025-11-10",
      "frequency": 4,
      "distributionType": "recurring"
    }
  ],
  "status": "OK",
  "nextUrl": "https://api.aries.com/v1/corporate-actions/dividends?next=..."
}

Query parameter notes

The tickers query parameter accepts a single symbol only. If you need multiple symbols, use tickersAnyOf with a comma-separated list.

The sort query parameter is a plain string, not an enum and not a separate asc / desc selector. Send the sort column together with its direction in the same value, for example sort=ticker.asc, sort=ex_dividend_date.desc, or sort=ticker.asc,ex_dividend_date.desc.

Authorizations

Authorization · string · header · required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Query Parameters

tickers · string

Single ticker symbol only, such as AAPL. Do not send a comma-separated list here; if you need multiple symbols, use tickersAnyOf instead.

Example:

"AAPL"

tickersAnyOf · string

Comma-separated list of ticker symbols.

Example:

"AAPL,MSFT,GOOG"

tickerFrom · string

Filter tickers >= this value (inclusive)

Example:

"A"

tickerAfter · string

Filter tickers > this value (exclusive)

Example:

"A"

tickerTo · string

Filter tickers <= this value (inclusive)

Example:

"Z"

tickerBefore · string

Filter tickers < this value (exclusive)

Example:

"Z"

exDividendDate · string<date>

Exact ex-dividend date in YYYY-MM-DD format

Example:

"2024-08-11"

exDividendDateFrom · string<date>

Ex-dividend start-date filter. Returns dividends with ex-dividend dates on or after this date.

Example:

"2024-01-01"

exDividendDateAfter · string<date>

Ex-dividend after-date filter. Returns dividends after this date, excluding the date itself.

Example:

"2024-01-01"

exDividendDateTo · string<date>

Ex-dividend end-date filter. Returns dividends with ex-dividend dates on or before this date.

Example:

"2024-12-31"

exDividendDateBefore · string<date>

Ex-dividend before-date filter. Returns dividends before this date, excluding the date itself.

Example:

"2024-12-31"

frequency · integer

Exact frequency (0=irregular, 1=annual, 4=quarterly, 12=monthly)

Example:

4

frequencyMin · integer

Dividend frequency lower-bound filter. Returns records with frequency greater than or equal to this value.

Example:

1

frequencyAbove · integer

Dividend frequency lower-bound filter. Returns records above this value, excluding the value itself.

Example:

0

frequencyMax · integer

Dividend frequency upper-bound filter. Returns records with frequency less than or equal to this value.

Example:

12

frequencyBelow · integer

Dividend frequency upper-bound filter. Returns records below this value, excluding the value itself.

Example:

13

distributionType · enum<string>

Exact type: recurring, special, supplemental, irregular, unknown

Available options: recurring, special, supplemental, irregular, unknown

Example:

"recurring"

distributionTypes · string

Comma-separated list of distribution types

Example:

"recurring,special"

limit · integer

Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (1-5000)

Required range: 1 <= x <= 5000

Example:

100

sort · string

A comma-separated list of sort columns. For each column, append .asc or .desc to specify direction. Defaults to ticker.asc when not specified. Examples: ticker.asc, ex_dividend_date.desc, or ticker.asc,ex_dividend_date.desc.

next · string

Opaque pagination cursor returned by a previous response. Omit on the first request, then pass the next_page (or equivalent) value from each response to walk through subsequent pages.

Response

200

application/json

Dividends data.

Dividends response