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

# Dividend history

`GET /api/earnings/dividend-history`

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

Returns dividend history for the given company symbol. Includes dividend per share (total dividends / shares outstanding),
payout ratio (dividends / net income), dividend coverage (operating cash flow / dividends), and year-over-year growth.
Non-dividend-paying companies return null values. Data is sourced from SEC XBRL filings (10-K and 10-Q).

## Query parameters

- `symbol` string
- `cik` integer
- `cusip` string
- `composite_figi` string
- `share_class_figi` string
- `currency` string
- `period` 'annual' | 'quarter' | 'ttm' — Reporting period: `annual`, `quarter`, or `ttm` (trailing twelve months). TTM sums the last 4 quarters for flow items and uses the latest quarter for point-in-time items.
- `limit` integer
- `splitAdjust` boolean

## Response `200`

Array of dividend history entries sorted most recent first

- object[]
  - `period` string — Fiscal period end date (YYYY-MM-DD)
  - `fiscalYear` integer — The company's fiscal year (handles non-December year-ends — AAPL FY ends Sep, COST FY ends Aug).
  - `fiscalPeriod` 'FY' | 'Q1' | 'Q2' | 'Q3' | 'Q4' | 'TTM' — Fiscal period of a reported value: `FY` (annual), `Q1`-`Q4` (quarterly), or `TTM` (trailing twelve months).
  - `dividendPerShare` number, nullable — Dividend per share (total dividends / weighted average shares outstanding)
  - `totalDividendsPaid` number, nullable — Total cash dividends paid in the requested currency (default USD)
  - `payoutRatio` number, nullable — Payout ratio as a decimal (dividends / net income). Above 1.0 means paying more than earned.
  - `dividendCoverage` number, nullable — Dividend coverage ratio (operating cash flow / dividends). Below 1.0 is unsustainable.
  - `dividendGrowth` number, nullable — Year-over-year dividend per share growth as a decimal (0.05 = 5%)

## 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)