Dividends
GET
/v3/reference/dividends
Retrieve a historical record of cash dividend distributions for a given ticker, including declaration, ex-dividend, record, and pay dates, as well as payout amounts and frequency. This endpoint consolidates key dividend information, enabling users to account for dividend income in returns, develop dividend-focused strategies, and support tax reporting needs.
Use Cases: Income analysis, total return calculations, dividend strategies, tax planning.
Query Parameters
ticker
string
Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.
ex_dividend_date
string
Query by ex-dividend date with the format YYYY-MM-DD.
record_date
string
Query by record date with the format YYYY-MM-DD.
declaration_date
string
Query by declaration date with the format YYYY-MM-DD.
pay_date
string
Query by pay date with the format YYYY-MM-DD.
frequency
enum (integer)
Query by the number of times per year the dividend is paid out. Possible values are 0 (one-time), 1 (annually), 2 (bi-annually), 4 (quarterly), 12 (monthly), 24 (bi-monthly), and 52 (weekly).
cash_amount
number
Query by the cash amount of the dividend.
dividend_type
enum (string)
Query by the type of dividend. Dividends that have been paid and/or are expected to be paid on consistent schedules are denoted as CD.
Special Cash dividends that have been paid that are infrequent or unusual, and/or can not be expected to occur in the future are denoted as SC.
order
enum (string)
Order results based on the `sort` field.
limit
integer
Limit the number of results returned, default is 10 and max is 1000.
sort
enum (string)
Sort field used for ordering.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page of data.
request_id
string
A request id assigned by the server.
results
array (object)
optional
An array of results containing the requested data.
cash_amount
number
The cash amount of the dividend per share owned.
currency
string
optional
The currency in which the dividend is paid.
declaration_date
string
optional
The date that the dividend was announced.
dividend_type
enum (CD, SC, LT, ST)
The type of dividend. Dividends that have been paid and/or are expected to be paid on consistent schedules are denoted as CD.
Special Cash dividends that have been paid that are infrequent or unusual, and/or can not be expected to occur in the future are denoted as SC.
Long-Term and Short-Term capital gain distributions are denoted as LT and ST, respectively.
ex_dividend_date
string
The date that the stock first trades without the dividend, determined by the exchange.
frequency
integer
The number of times per year the dividend is paid out. Possible values are 0 (one-time), 1 (annually), 2 (bi-annually), 4 (quarterly), 12 (monthly), 24 (bi-monthly), and 52 (weekly).
id
string
The unique identifier of the dividend.
pay_date
string
optional
The date that the dividend is paid out.
record_date
string
optional
The date that the stock must be held to receive the dividend, set by the company.
ticker
string
The ticker symbol of the dividend.
status
string
optional
The status of this request's response.