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>'
import requests

url = "https://api.aries.com/v1/corporate-actions/dividends"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aries.com/v1/corporate-actions/dividends', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aries.com/v1/corporate-actions/dividends",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aries.com/v1/corporate-actions/dividends"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.aries.com/v1/corporate-actions/dividends")
  .header("Authorization", "Bearer <token>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.aries.com/v1/corporate-actions/dividends")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
{
  "results": [
    {
      "ticker": "AAPL",
      "cashAmount": 0.26,
      "exDividendDate": "2025-11-10",
      "payDate": "2025-11-13",
      "recordDate": "2025-11-10",
      "frequency": 4,
      "distributionType": "recurring"
    }
  ],
  "status": "OK",
  "requestId": "abdd5e0f749621028802750474bc45cc",
  "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

​
ticker
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

Dividends data.

​
results
object[]

Array of dividend payment events.

​
nextUrl
string

Opaque pagination URL for the next page of results when more data is available.

​
requestId
string

Provider request identifier for tracing and support.

​
status
string

Provider response status.