Skip to main content
GET
/
v1
/
corporate-actions
/
dividends
Get Dividend History
curl --request GET \
  --url https://api.aries.com/v1/corporate-actions/dividends \
  --header 'Authorization: Bearer <token>'
{
  "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=..."
}

Documentation Index

Fetch the complete documentation index at: https://finance.dev/llms.txt

Use this file to discover all available pages before exploring further.

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, such as AAPL. Use it to narrow results to one company.

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

Sort columns with direction (e.g., ticker.asc, ex_dividend_date.desc)

Example:

"ex_dividend_date.desc"

​
next
string

Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page. from previous response

Response

Dividends data.

Dividends response