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

Name Description Type Additional 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

Name Description Type Additional information SIP Provider
underlying_symbol

Symbol of equity or ETF

string

None

None

announcement_date

Date dividend was announced

string

Represented as 'YYYY-MM-DD'

None

ex_date

Ex-dividend date

string

Represented as 'YYYY-MM-DD'

None

record_date

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

string

Represented as 'YYYY-MM-DD'

None

payment_date

Payment date

string

Represented as 'YYYY-MM-DD'

None

amount

Actual or projected distribution amount

decimal number

None

None

Status of dividend

DividendStatus

None

None

DividendStatus

Possible enumeration values:

Value Description

confirmed

projected

Frequency of dividend payment.

Frequency

None

None

Frequency

Possible enumeration values:

Value Description

annual

semi-annual

quarterly

monthly

bi-monthly

special

unknown

Type of asset

AssetType

None

None

AssetType

Possible enumeration values:

Value Description

stock

etf

Source of dividends

DataSource

None

None

DataSource

Possible enumeration values:

Value Description

unknown

projected

market_implied

Dividend code

DividendCode

None

None

DividendCode

Possible enumeration values:

Value Description

unknown

regular

special

currency

Currency of distribution

string

None

None

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

None

DistributionDetails

Name Description Type Additional information SIP Provider
amount

Actual or projected distribution amount

decimal number

None

None

Type of distribution. For Stocks, dividends are reported. For ETFs, dividends, short-term capital gains, long-term capital gains, return of capital, or other distributions are reported.

DistributionType

None

None

DistributionType

Possible enumeration values:

Value Description

dividend

st_capital_gain

lt_capital_gain

roc

other

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>