---
title: "Upcoming dividends"
method: GET
path: "/api/earnings/upcoming-dividends"
tags: ["Earnings"]
---

# Upcoming dividends

`GET /api/earnings/upcoming-dividends`

![Stock](https://img.shields.io/badge/Stock-f97316) ![Pro](https://img.shields.io/badge/Pro-8b5cf6)

Declared dividends with an ex-dividend date in the next N days (default 7, max 28), sorted by ex-date ascending. Covers common stocks with an active listing; fund and ETF distributions are not included. Each entry is one dividend event: ex-date, payment/record/announcement dates when declared, dividend per share, and the indicated annual dividend. Delisted companies (no active listing on any exchange) are excluded.

Amounts are declared in USD. When a different `currency` is requested, `dividendPerShare` and `indicatedAnnualDividend` are converted using the most recent available exchange rate (the events are in the future, so no historical rate exists yet); the `currency` field states the currency of the returned amounts.

## Query parameters

- `days` integer
- `page` integer
- `pageSize` integer
- `currency` string

## Response `200`

Paginated list of upcoming dividend events.

- object
  - `page` integer — Current page number (1-indexed).
  - `pageSize` integer — Number of results per page.
  - `totalPages` integer — Total number of pages.
  - `totalResults` integer — Total dividend events in the window.
  - `data` object[]
    - `symbols` string[] — All active tickers for the entity, primary first. A multi-class issuer is a single entry with all classes.
    - `name` string — Issuer name (SEC conformed form).
    - `exDate` string — Ex-dividend date (YYYY-MM-DD). Shares bought on or after this date do not receive the dividend.
    - `paymentDate` string, nullable — Payment date (YYYY-MM-DD). Null when not yet declared.
    - `recordDate` string, nullable — Record date (YYYY-MM-DD). Null when not yet declared.
    - `announcementDate` string, nullable — Declaration date (YYYY-MM-DD). Null when unavailable.
    - `dividendPerShare` number, nullable — Declared dividend per share for this event, in the returned `currency`.
    - `indicatedAnnualDividend` number, nullable — Indicated annual dividend per share (declared amount annualized by payment frequency), in the returned `currency`.
    - `currency` string — Currency of the returned amounts. Echoes the requested target currency; USD when no conversion applies.

## Other responses

- `400` — Invalid parameters
- `403` — Feature not available on current plan

---

[API](https://skmtc.net/stockfit/apis/stockfit-api.md) · [All operations](https://skmtc.net/stockfit/apis/stockfit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockfit/stockfit-api/revisions/3d5897270d8a/schema)