Dividends

The Dividends endpoints provide access to dividend calendars, payment histories, ex-dividend dates, and comprehensive dividend data for individual stocks.

GETGet dividend calendar

/v1/dividends/calendar

Get upcoming dividend events (ex-dates, payment dates) with flexible date filtering. Perfect for tracking upcoming dividends across your portfolio or the entire market.

Parameters

Name	Type	Description
range	string	Preset range: 1w, 1m, 3m, 6m, 1y
start_date	date	Start date (YYYY-MM-DD)
end_date	date	End date (YYYY-MM-DD)
symbols	string	Comma-separated symbols to filter
min_yield	float	Minimum dividend yield %
limit	integer	Max results (default 100, max 5000)
sort	string	Sort order: asc or desc

Example Request

curl "https://api.divv.io/v1/dividends/calendar?range=1m"

GETGet dividend history

/v1/dividends/history

Get historical dividend payments across multiple symbols. Returns a list of past dividend payments with optional date filtering.

Parameters

Name	Type	Description
symbols	string	Required. Comma-separated symbols
start_date	date	Start date (YYYY-MM-DD)
end_date	date	End date (YYYY-MM-DD)
limit	integer	Results per page (max 1000)

GETGet stock dividend summary

/v1/stocks/{symbol}/dividends

Get complete dividend data for a specific stock including current yield, next payment, historical payments, and growth metrics.

Path Parameters

Name	Type	Description
symbol	string	Stock symbol (e.g., "JNJ")

Query Parameters

Name	Type	Description
include_future	boolean	Include future scheduled dividends (default true)
years	integer	Years of history (default 5, max 30)

Returns

Returns a dividend summary object with:

current: Current yield, annual amount, frequency, payout ratio
next_payment: Next scheduled dividend event
history: Historical dividend payments
growth: Dividend growth metrics
consistency: Payment consistency data

GETGet dividend history by symbol

/v1/dividends/{symbol}

Get dividend history for a specific stock symbol with optional date filtering.

Path Parameters

Name	Type	Description
symbol	string	Stock symbol

GETGet upcoming ex-dividend dates

/v1/dividends/ex-dates

Get stocks with upcoming ex-dividend dates. Useful for dividend capture strategies.

Parameters

Name	Type	Description
days	integer	Days ahead to look (default 14, max 90)
min_yield	float	Minimum dividend yield %
sector	string	Filter by sector
limit	integer	Results limit (max 500)

GETGet upcoming payment dates

/v1/dividends/payment-dates

Get stocks with upcoming dividend payment dates. Returns stocks with dividend payments scheduled within the specified period.

Parameters

Name	Type	Description
days	integer	Days ahead to look (default 30, max 90)
limit	integer	Results limit (max 500)