---
title: "Dividends v3"
method: GET
path: "/v3/reference/dividends"
tags: ["reference:dividends"]
---

# Dividends v3

`GET /v3/reference/dividends`

Get a list of historical cash dividends, including the ticker symbol,
declaration date, ex-dividend date, record date, pay date, frequency,
and amount.

## Query parameters

- `ticker` string
- `ex_dividend_date` string, date
- `record_date` string, date
- `declaration_date` string, date
- `pay_date` string, date
- `frequency` 0 | 1 | 2 | 4 | 12 | 24 | 52
- `cash_amount` number
- `dividend_type` 'CD' | 'SC' | 'LT' | 'ST' — The type of dividend. Dividends that have been paid and/or are expected to be paid on consistent schedules are denoted as CD. Special Cash dividends that have been paid that are infrequent or unusual, and/or can not be expected to occur in the future are denoted as SC. Long-Term and Short-Term capital gain distributions are denoted as LT and ST, respectively.
- `ticker.gte` string
- `ticker.gt` string
- `ticker.lte` string
- `ticker.lt` string
- `ex_dividend_date.gte` string, date
- `ex_dividend_date.gt` string, date
- `ex_dividend_date.lte` string, date
- `ex_dividend_date.lt` string, date
- `record_date.gte` string, date
- `record_date.gt` string, date
- `record_date.lte` string, date
- `record_date.lt` string, date
- `declaration_date.gte` string, date
- `declaration_date.gt` string, date
- `declaration_date.lte` string, date
- `declaration_date.lt` string, date
- `pay_date.gte` string, date
- `pay_date.gt` string, date
- `pay_date.lte` string, date
- `pay_date.lt` string, date
- `cash_amount.gte` number
- `cash_amount.gt` number
- `cash_amount.lte` number
- `cash_amount.lt` number
- `order` 'asc' | 'desc'
- `limit` integer
- `sort` 'ex_dividend_date' | 'pay_date' | 'declaration_date' | 'record_date' | 'cash_amount' | 'ticker'

## Response `200`

OK

- object — A list of dividends.
  - `next_url` string — If present, this value can be used to fetch the next page of data.
  - `request_id` string, required — A request id assigned by the server.
  - `results` object[] — An array of results containing the requested data.
    - `cash_amount` number, required — The cash amount of the dividend per share owned.
    - `currency` string — The currency in which the dividend is paid.
    - `declaration_date` string — The date that the dividend was announced.
    - `dividend_type` 'CD' | 'SC' | 'LT' | 'ST', required — The type of dividend. Dividends that have been paid and/or are expected to be paid on consistent schedules are denoted as CD. Special Cash dividends that have been paid that are infrequent or unusual, and/or can not be expected to occur in the future are denoted as SC. Long-Term and Short-Term capital gain distributions are denoted as LT and ST, respectively.
    - `ex_dividend_date` string, required — The date that the stock first trades without the dividend, determined by the exchange.
    - `frequency` integer, required — The number of times per year the dividend is paid out. Possible values are 0 (one-time), 1 (annually), 2 (bi-annually), 4 (quarterly), 12 (monthly), 24 (bi-monthly), and 52 (weekly).
    - `id` string, required — The unique identifier of the dividend.
    - `pay_date` string — The date that the dividend is paid out.
    - `record_date` string — The date that the stock must be held to receive the dividend, set by the company.
    - `ticker` string, required — The ticker symbol of the dividend.
  - `status` string — The status of this request's response.

---

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