Sign in
latestOpenAPI 3.0.32026-08-101461131.1 MB

ad6f143e43aa

reference:dividends

Dividends v3

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

get/v3/reference/dividends

Query parameters

tickerstring

Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.

ex_dividend_datestring date

Query by ex-dividend date with the format YYYY-MM-DD.

record_datestring date

Query by record date with the format YYYY-MM-DD.

declaration_datestring date

Query by declaration date with the format YYYY-MM-DD.

pay_datestring date

Query by pay date with the format YYYY-MM-DD.

frequency0 | 1 | 2 | 4 | 12 | 24 | 52

Query by 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).

cash_amountnumber

Query by the cash amount of the dividend.

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.

Query by 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.

ticker.gtestring

Range by ticker.

ticker.gtstring

Range by ticker.

ticker.ltestring

Range by ticker.

ticker.ltstring

Range by ticker.

ex_dividend_date.gtestring date

Range by ex_dividend_date.

ex_dividend_date.gtstring date

Range by ex_dividend_date.

ex_dividend_date.ltestring date

Range by ex_dividend_date.

ex_dividend_date.ltstring date

Range by ex_dividend_date.

record_date.gtestring date

Range by record_date.

record_date.gtstring date

Range by record_date.

record_date.ltestring date

Range by record_date.

record_date.ltstring date

Range by record_date.

declaration_date.gtestring date

Range by declaration_date.

declaration_date.gtstring date

Range by declaration_date.

declaration_date.ltestring date

Range by declaration_date.

declaration_date.ltstring date

Range by declaration_date.

pay_date.gtestring date

Range by pay_date.

pay_date.gtstring date

Range by pay_date.

pay_date.ltestring date

Range by pay_date.

pay_date.ltstring date

Range by pay_date.

cash_amount.gtenumber

Range by cash_amount.

cash_amount.gtnumber

Range by cash_amount.

cash_amount.ltenumber

Range by cash_amount.

cash_amount.ltnumber

Range by cash_amount.

order'asc' | 'desc'
Example:asc

Order results based on the sort field.

limitinteger
Example:10

Limit the number of results returned, default is 10 and max is 1000.

sort'ex_dividend_date' | 'pay_date' | 'declaration_date' | 'record_date' | 'cash_amount' | 'ticker'
Example:ex_dividend_date

Sort field used for ordering.

Response

OK

next_urlstring

If present, this value can be used to fetch the next page of data.

request_idstring required

A request id assigned by the server.

statusstring

The status of this request's response.

Example response

{
  "next_url": "https://api.massive.com/v3/reference/dividends/AAPL?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
  "request_id": "6a7e466379af0a71039d60cc78e72282",
  "results": [
    {
      "cash_amount": 0.22,
      "declaration_date": "2021-10-28",
      "dividend_type": "CD",
      "ex_dividend_date": "2021-11-05",
      "frequency": 4,
      "id": "E8e3c4f794613e9205e2f178a36c53fcc57cdabb55e1988c87b33f9e52e221444",
      "pay_date": "2021-11-11",
      "record_date": "2021-11-08",
      "ticker": "AAPL"
    },
    {
      "cash_amount": 0.22,
      "declaration_date": "2021-07-27",
      "dividend_type": "CD",
      "ex_dividend_date": "2021-08-06",
      "frequency": 4,
      "id": "E6436c5475706773f03490acf0b63fdb90b2c72bfeed329a6eb4afc080acd80ae",
      "pay_date": "2021-08-12",
      "record_date": "2021-08-09",
      "ticker": "AAPL"
    }
  ],
  "status": "OK"
}