---
title: "Dividend date"
method: GET
path: "/api/earnings/dividend-date"
tags: ["Earnings"]
---

# Dividend date

`GET /api/earnings/dividend-date`

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

Next declared dividend for a single stock: ex-dividend date, payment/record/announcement dates, dividend per share, and indicated annual dividend. Unlike the earnings date there is no prediction involved, a dividend exists only once the company declares it. Companies with no declared upcoming dividend (including non-dividend payers) return `null` for every field.

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

## Query parameters

- `symbol` string
- `cik` integer
- `cusip` string
- `composite_figi` string
- `share_class_figi` string
- `currency` string

## Response `200`

Next declared dividend for the symbol

- object
  - `symbol` string
  - `exDate` string, nullable — Ex-dividend date (YYYY-MM-DD). Shares bought on or after this date do not receive the dividend. Null when no upcoming dividend is declared.
  - `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 or symbol not found
- `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)