Dividends

Dividend endpoints for upcoming events and historical payments. All endpoints require an API key.

GETDividend calendar

/v1/dividends/calendar

Returns upcoming dividend payment events within a date range.

Name	Type	Description
start_date	date	Optional. YYYY-MM-DD. Defaults to today.
end_date	date	Optional. YYYY-MM-DD. Defaults to start_date + 30 days.
limit	integer	Optional. 1-500 (default 100).

curl "https://divv-api-production.up.railway.app/v1/dividends/calendar?start_date=2026-03-01&end_date=2026-03-31" \
  -H "Authorization: Bearer YOUR_API_KEY"

GETDividend history

/v1/dividends/history

Returns historical dividend payments for one or more symbols.

Name	Type	Description
symbols	string	Required. Comma-separated symbols (max 50).
start_date	date	Optional. YYYY-MM-DD.
end_date	date	Optional. YYYY-MM-DD.
limit	integer	Optional. 1-1000 (default 100).
cursor	string	Optional pagination cursor.

curl "https://divv-api-production.up.railway.app/v1/dividends/history?symbols=AAPL,MSFT,JNJ&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

GETEx-dividend dates

/v1/dividends/ex-dates

Returns stocks with upcoming ex-dividend dates.

Name	Type	Description
start_date	date	Optional. Defaults to today.
end_date	date	Optional. Defaults to start_date + 7 days.
min_yield	float	Optional minimum dividend yield percent.
sector	string	Optional sector filter.
limit	integer	Optional. 1-500 (default 100).

curl "https://divv-api-production.up.railway.app/v1/dividends/ex-dates?min_yield=3&limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

GETPayment dates

/v1/dividends/payment-dates

Returns stocks with dividend payments in a date range.

Name	Type	Description
start_date	date	Optional. Defaults to today.
end_date	date	Optional. Defaults to start_date + 30 days.
min_amount	float	Optional minimum cash dividend amount.
limit	integer	Optional. 1-500 (default 100).

curl "https://divv-api-production.up.railway.app/v1/dividends/payment-dates?min_amount=0.5&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

GETSymbol dividend historyStarter+

/v1/stocks/{symbol}/dividends

Returns dividend records for a single symbol.

Name	Type	Description
symbol	path	Required ticker symbol.
limit	integer	Optional. 1-100 (default 20).

curl "https://divv-api-production.up.railway.app/v1/stocks/JNJ/dividends?limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

Notes

GET /v1/dividends/calendar is payment-date focused.
For ex-dividend event discovery, use GET /v1/dividends/ex-dates.
Responses use a consistent data and optional meta envelope.