Login
< API Reference
GET
/events/dividends?symbols={symbols}&start_date={start_date}&end_date={end_date}
Get dividend information

Example URI

https://api.livevol.com/v1/events/dividends?symbols=DAL&start_date=2019-01-01&end_date=2019-06-30

Request Information

URI Parameters

NameDescriptionTypeAdditional information
symbols

Comma-separated list of symbols or special symbol ('all_symbols', 'all_optionable_symbols')

 string

Required
start_date

Start date in YYYY-MM-DD format. Optional.

 string

Constraint: value should be less than or equal to end_date value

Date in yyyy-MM-dd format. (i.e. 2019-01-18)

Default value is: 2003-01-01
end_date

End date in YYYY-MM-DD format. Optional.

 string

Constraint: value should be greater than or equal to start_date value

Date in yyyy-MM-dd format. (i.e. 2019-01-18)

Default value is: 2100-01-01

Response Information

Resource Description

Collection of Dividend

NameDescriptionTypeAdditional information
underlying_symbol

Symbol of equity or ETF

 string

None.
announcement_date

Date dividend was announced

 string

Represented as 'YYYY-MM-DD'
ex_date

Ex-dividend date

 string

Represented as 'YYYY-MM-DD'
record_date

Date before which holders-of-record will receive the dividend.

 string

Represented as 'YYYY-MM-DD'
payment_date

Payment date

 string

Represented as 'YYYY-MM-DD'
amount

Actual or projected distribution amount

 decimal number

None.
dividend_status

Status of dividend

 DividendStatus

None.
frequency

Frequency of dividend payment.

 Frequency

None.
asset_type

Type of asset

 AssetType

None.
data_source

Source of dividends

 DataSource

None.
dividend_code

Dividend code

 DividendCode

None.
currency

Currency of distribution

 string

None.
distribution_details

Distribution breakdown. For Stocks, dividends are reported, including special dividend payments. For ETFs, dividends, short-term capital gains, long-term capital gains, return of capital, or other distributions are reported.

 Collection of DistributionDetails

None.

Response Formats

application/json, text/json

Sample: 
[
  {
    "underlying_symbol": "AAPL",
    "announcement_date": "2016-06-30",
    "ex_date": "2016-06-30",
    "record_date": "2016-06-30",
    "payment_date": "2016-07-10",
    "amount": 0.115,
    "dividend_status": "confirmed",
    "frequency": "annual",
    "asset_type": "stock",
    "data_source": "projected",
    "dividend_code": "regular",
    "currency": "USD",
    "distribution_details": [
      {
        "amount": 0.115,
        "distribution_type": "dividend"
      }
    ]
  },
  {
    "underlying_symbol": "IBM",
    "announcement_date": "2016-09-30",
    "ex_date": "2016-09-30",
    "record_date": "2016-09-30",
    "payment_date": "2016-10-23",
    "amount": 0.115,
    "dividend_status": "confirmed",
    "frequency": "annual",
    "asset_type": "stock",
    "data_source": "market_implied",
    "dividend_code": "regular",
    "currency": null,
    "distribution_details": [
      {
        "amount": 0.115,
        "distribution_type": "dividend"
      }
    ]
  }
]

application/xml, text/xml

Sample: 
<dividends xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <dividend>
    <amount>0.115</amount>
    <announcement_date>2016-06-30</announcement_date>
    <asset_type>stock</asset_type>
    <currency>USD</currency>
    <data_source>projected</data_source>
    <distribution_details>
      <distribution_details>
        <amount>0.115</amount>
        <distribution_type>dividend</distribution_type>
      </distribution_details>
    </distribution_details>
    <dividend_code>regular</dividend_code>
    <dividend_status>confirmed</dividend_status>
    <ex_date>2016-06-30</ex_date>
    <frequency>annual</frequency>
    <payment_date>2016-07-10</payment_date>
    <record_date>2016-06-30</record_date>
    <underlying_symbol>AAPL</underlying_symbol>
  </dividend>
  <dividend>
    <amount>0.115</amount>
    <announcement_date>2016-09-30</announcement_date>
    <asset_type>stock</asset_type>
    <currency i:nil="true" />
    <data_source>market_implied</data_source>
    <distribution_details>
      <distribution_details>
        <amount>0.115</amount>
        <distribution_type>dividend</distribution_type>
      </distribution_details>
    </distribution_details>
    <dividend_code>regular</dividend_code>
    <dividend_status>confirmed</dividend_status>
    <ex_date>2016-09-30</ex_date>
    <frequency>annual</frequency>
    <payment_date>2016-10-23</payment_date>
    <record_date>2016-09-30</record_date>
    <underlying_symbol>IBM</underlying_symbol>
  </dividend>
</dividends>