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>'
{
  "dividends": [
    {
      "symbol": "AAPL",
      "amount": 0.25999999046325684,
      "exDate": "2025-11-10",
      "paymentDate": "2025-11-13",
      "recordDate": "2025-11-10",
      "frequency": "2"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
ticker
string

Single ticker symbol

Example:

"AAPL"

​
tickers
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 date >= (inclusive)

Example:

"2024-01-01"

​
exDividendDateAfter
string<date>

Ex-dividend date > (exclusive)

Example:

"2024-01-01"

​
exDividendDateTo
string<date>

Ex-dividend date <= (inclusive)

Example:

"2024-12-31"

​
exDividendDateBefore
string<date>

Ex-dividend date < (exclusive)

Example:

"2024-12-31"

​
frequency
integer

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

Example:

4

​
frequencyMin
integer

Frequency >= (inclusive)

Example:

1

​
frequencyAbove
integer

Frequency > (exclusive)

Example:

0

​
frequencyMax
integer

Frequency <= (inclusive)

Example:

12

​
frequencyBelow
integer

Frequency < (exclusive)

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 (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 previous response

Response

200 - application/json

Dividends data.

​
dividends
object[]

Array of dividend payment events