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

# Dividend history

`GET /api/earnings/dividend-history`

## Request

- Base URL: `https://api.stockfit.io/v1`
- URL: `https://api.stockfit.io/v1/api/earnings/dividend-history`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/stockfit/apis/stockfit-api/docs/api/earnings/dividend-history/get.ts> (a function with typed inputs; its response is checked against the schema)

![Free](https://img.shields.io/badge/Free-22c55e) ![Starter](https://img.shields.io/badge/Starter-3b82f6) ![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.dev/stockfit/apis/stockfit-api.md) - [All operations](https://skmtc.dev/stockfit/apis/stockfit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stockfit/apis/stockfit-api/revisions/ade8e65563c3?raw)