Dividends
GET
/stocks/v1/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 adjustment factors for normalizing historical data to offset the effects of dividends. 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.
Plan Accessloading..
Plan
Recency
Updated daily
Updated daily
Updated daily
Updated daily
Updated daily
Plan Recencyloading..
Plan
History
2 years
All history
All history
All history
All history
Plan Historyloading..
Query Parameters
ticker
string
Stock symbol for the company issuing the dividend
ex_dividend_date
string
Date when the stock begins trading without the dividend value Value must be formatted 'yyyy-mm-dd'.
frequency
integer
How many times per year this dividend is expected to occur. A value of 0 means the distribution is non-recurring or irregular (e.g., special, supplemental, or a one-off dividend). Other possible values include 1 (annual), 2 (semi-annual), 3 (trimester), 4 (quarterly), 12 (monthly), 24 (bi-monthly), 26 (bi-weekly), 52 (weekly), and 365 (daily) depending on the issuer's declared or inferred payout cadence. Value must be an integer.
distribution_type
enum (string)
Classification describing the nature of this dividend's recurrence pattern: recurring (paid on a regular schedule), special (one-time or commemorative), supplemental (extra beyond the regular schedule), irregular (unpredictable or non-recurring), unknown (cannot be classified from available data)
limit
integer
Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '5000'.
sort
string
A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'ticker' if not specified. The sort order defaults to 'asc' if not specified.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page.
request_id
string
A request id assigned by the server.
results
array (object)
The results for this request.
cash_amount
number
optional
Original dividend amount per share in the specified currency
currency
string
optional
Currency code for the dividend payment (e.g., USD, CAD)
declaration_date
string
optional
Date when the company officially announced the dividend
distribution_type
string
Classification describing the nature of this dividend's recurrence pattern: recurring (paid on a regular schedule), special (one-time or commemorative), supplemental (extra beyond the regular schedule), irregular (unpredictable or non-recurring), unknown (cannot be classified from available data)
ex_dividend_date
string
optional
Date when the stock begins trading without the dividend value
frequency
integer
optional
How many times per year this dividend is expected to occur. A value of 0 means the distribution is non-recurring or irregular (e.g., special, supplemental, or a one-off dividend). Other possible values include 1 (annual), 2 (semi-annual), 3 (trimester), 4 (quarterly), 12 (monthly), 24 (bi-monthly), 26 (bi-weekly), 52 (weekly), and 365 (daily) depending on the issuer's declared or inferred payout cadence.
historical_adjustment_factor
number
optional
Cumulative adjustment factor used to offset dividend effects on historical prices. To adjust a historical price for dividends: for a price on date D, find the first dividend whose `ex_dividend_date` is after date D and multiply the price by that dividend's `historical_adjustment_factor`.
id
string
optional
Unique identifier for each dividend record
pay_date
string
optional
Date when the dividend payment is distributed to shareholders
record_date
string
optional
Date when shareholders must be on record to be eligible for the dividend payment
split_adjusted_cash_amount
number
optional
Dividend amount adjusted for stock splits that occurred after the dividend was paid, expressed on a current share basis
ticker
string
optional
Stock symbol for the company issuing the dividend
status
enum (OK)
The status of this request's response.
Code Examples
Query URL
GET
loading...Run query unavailable
Create account or sign in to Massive
Scroll to see updated query response
Response Object