# Dividends

Corporate action dividend. A distribution of a company earnings to a specified class of its shareholders and alters the stock price. Includes international symbols. History available since 2003. This endpoint covers over 39,000 U.S. equities, international dividends, mutual funds, ADRs, and ETFs.<p>Here is what you will get:</p><ul><li>Detailed information on both cash and stock dividends including record, payment, ex, and announce dates</li><li>Gross and net amounts</li><li>Details of all currencies in which a dividend can be paid</li><li>Tax information</li><li>The ability to keep up with the growing number of complex dividend distributions</li></ul>

- **Category:** Corporate Actions
- **Type:** historical
- **Workspace:** EDGE
- **Dataset Id:** ADVANCED_DIVIDENDS
- **Region:** US
- **Records:** 5,401,871
- **Newest Record:** 2226-07-01
- **Oldest Record:** 1996-04-21
- **Updated At:** 2026-11-22

**Access:** [Get access](https://console.vianexus.com/console/marketplace) · [Start free trial](https://console.vianexus.com/auth/register)

## Provider

Published by EDI

Website: https://www.exchange-data.com/

## Methods

### Batch API

- `https://api.blueskyapi.com/v1/data/EDGE/ADVANCED_DIVIDENDS`
- `https://api.blueskyapi.com/v1/data/EDGE/ADVANCED_DIVIDENDS/:symbol`
- `https://api.blueskyapi.com/v1/data/EDGE/ADVANCED_DIVIDENDS/:symbol/::refid`
- `https://api.blueskyapi.com/v1/data/edge/advanced_dividends?range=last-week`
- `https://api.blueskyapi.com/v1/data/edge/advanced_dividends/aapl?last=4`
- `https://api.blueskyapi.com/v1/data/edge/advanced_dividends/AAPL,MSFT,VZ`

Example API request: `https://api.blueskyapi.com/v1/data/EDGE/ADVANCED_DIVIDENDS?last=1`

You can fetch up to 2000 symbols at a time using a comma-separated list. EX: AAPL,MSFT,TSLA

#### Time Series Query Parameters

You can use any time series query parameters with this dataset. [Full documentation](https://console.vianexus.com/docs/api-basics/time-series-data)

## Response Attributes

Key          | Type   | Description
-------------|--------|-------------
__adrFee__  | number, null | ADR custody fee amount.
__amount__  | number, null | The split-adjusted gross dividend amount; if a gross amount is not available, the split-adjusted net dividend amount is used.
__announceDate__  | string, null | Date on which the company announces that it is issuing a dividend in the future. The format is `YYYY-MM-DD`.
__countryCode__  | string, null | Country code for the symbol, using [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)
__coupon__  | number, null | Coupon payment or interest rate paid.
__created__  | string, null | Date the dividend record was created. The format is `YYYY-MM-DD`.
__currency__  | string, null | [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html) for the `amount`
__declaredCurrencyCD__  | string, null | [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html) for certificate of deposit.
__declaredDate__  | string, null | Date on which the company announces that it is issuing a dividend in the future. The format is `YYYY-MM-DD`.
__declaredGrossAmount__  | number, null | Declared gross amount.
__description__  | string, null | Security description
__exDate__ `date` | string, null | Date that determines which shareholders are entitled to receive the dividend. Typically, the ex-dividend date is set two business days before the record date. Only those shareholders who owned their shares at least two full business days before the record date are entitled to receive the dividend. The format is `YYYY-MM-DD`.
__figi__  | string, null | OpenFIGI ID for the symbol.
__fiscalYearEndDate__  | string, null | Fiscal year end date. The format is `YYYY-MM-DD`.
__flag__  | string, null | Payment type.<br>**Supported values:**<br>&bull; `Autocall`<br>&bull; `Cash&Stock`<br>&bull; `Cash`<br>&bull; `DissenterRights`<br>&bull; `Interest`<br>&bull; `Maturity`<br>&bull; `Rebate`<br>&bull; `Stock`<br>&bull; `Special`<br>&bull; `ToBeAnnounced`<br>&bull; `Blank`
__frequency__  | string, null | How often the dividend is paid.<br>**Supported Values:**<br>&bull; Every 35 Days<br>&bull; Annual<br>&bull; BiMonthly<br>&bull; Daily<br>&bull; Final<br>&bull; Interim<br>&bull; Interest on Maturity<br>&bull; Interest on Trigger<br>&bull; Irregular<br>&bull; Monthly<br>&bull; Quarterly<br>&bull; Semi-Annual<br>&bull; Trimesterly<br>&bull; Unspecified<br>&bull; Weekly<br>&bull; Blank
__fromFactor__  | number, null | Number of starting shares.
__fxDate__  | string, null | Date used for the FX(Foreign exchange) rate. The format is `YYYY-MM-DD`.
__grossAmount__  | number, null | Dividend return on a stock before any expenses, taxes or deductions are taken into account.
__installmentPayDate__  | string, null | Installment payment date. The format is `YYYY-MM-DD`.
__isApproximate__  | boolean, null | Is approximate
__isCapitalGains__  | boolean, null | Is capital gains
__isDAP__  | boolean, null | Is a Dividend Advantage Portfolio, a unit investment trust.
__isNetInvestmentIncome__  | boolean, null | Net investment income (NII) is income received from investment assets (before taxes) such as bonds, stocks, mutual funds, loans, and other investments (less related expenses). The individual tax rate on net investment income depends on whether it is interest income, dividend income, or capital gains. [Investopedia](https://www.investopedia.com/terms/n/netinvestmentincome.asp)
__lastUpdated__  | string, null | Date the dividend record was last changed. The format is `YYYY-MM-DD`.
__marker__  | string, null | **Supported Values:**<br>&bull; Annual<br>&bull; Arrears<br>&bull; Capital Gain<br>&bull; Capital Gain Long Term<br>&bull; Capital Gain Short Term<br>&bull; Final<br>&bull; Installment<br>&bull; Interim<br>&bull; Interest on Capital<br>&bull; Memorial<br>&bull; Regular<br>&bull; Special<br>&bull; Supplementary<br>&bull; Unspecified
__netAmount__  | number, null | Net amount is the dividend return after tax.
__notes__  | string, null | Long description
__optionalElectionDate__  | string, null | Optional election date. The format is `YYYY-MM-DD`.
__parValue__  | number, null | For a stock, par value is the stock value stated in the corporate charter. For a bond, par value is the face value. Par value for a fixed-income instrument security, such as a bond, determines its maturity value and dollar value of coupon payments.
__parValueCurrency__  | string, null | [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html) for the `parValue`
__paymentDate__  | string, null | Date the eligible shareholders are paid. The format is `YYYY-MM-DD`.
__periodEndDate__  | string, null | Period end date. The format is `YYYY-MM-DD`.
__recordDate__  | string, null | Date the company examines its current list of shareholders to determine who receives dividends. Only shareholders in the company books as of this date are entitled to receive dividends. The format is `YYYY-MM-DD`.
__refid__ `subkey` | string | Unique ID representing the dividend record.
__registrationDate__  | string, null | Registration date. The format is `YYYY-MM-DD`.
__secondExDate__  | string, null | Second ex-dividend date (see `exDate`). The format is `YYYY-MM-DD`.
__secondPaymentDate__  | string, null | Second payment date. The format is `YYYY-MM-DD`.
__securityType__  | string, null | Type of security.<br>**Supported Values:**<br>&bull; A BLANK value is possible<br>&bull; Barbados Depository Receipts<br>&bull; Bond<br>&bull; Basket Warrant<br>&bull; Convertible Debenture<br>&bull; Share Depository Certificate<br>&bull; Chess Depository Interest<br>&bull; CEDEAR<br>&bull; Convertible Notes<br>&bull; Conversion<br>&bull; Commodity<br>&bull; Certificate<br>&bull; Convertible Unsecured Loan Stock<br>&bull; Currency<br>&bull; Contingent Value Rights<br>&bull; Covered Warrant<br>&bull; Debenture<br>&bull; Derivatives<br>&bull; Depository Receipts<br>&bull; Distribution Rights<br>&bull; Deferred Settlement Trading<br>&bull; Equity Shares<br>&bull; Exchange Traded Commodities<br>&bull; Exchange Traded Fund<br>&bull; Exchange Traded Notes<br>&bull; Fund<br>&bull; Global Depository Notes<br>&bull; Irredeemable Convertible Loan Stock<br>&bull; Index<br>&bull; Interval Fund<br>&bull; Inflation<br>&bull; Interbank Offered Rate<br>&bull; Letter of Allotment<br>&bull; Unit Trust<br>&bull; Non Convertible Debenture<br>&bull; Non-Redeemable Convertible Cumulative Preference S<br>&bull; Notes<br>&bull; Partly Convertible Debenture<br>&bull; Perpetual Exchangeable Repurchaseable Listed Share<br>&bull; Preferred Security<br>&bull; Poison Pill Rights<br>&bull; Preference Share<br>&bull; Parallel Line<br>&bull; Redeemable Convertible Secured Loan Stocks<br>&bull; Redeemable Convertible Secured Notes<br>&bull; Receipt<br>&bull; Redemption Rights<br>&bull; Redeemable Shares<br>&bull; Redeemable Optional Convertible Preference Shares<br>&bull; rights<br>&bull; Redeemable Unconvertible Notes<br>&bull; Structured Product<br>&bull; Subscription Receipts<br>&bull; Second Trading Line<br>&bull; Stapled Security<br>&bull; Swap Rate<br>&bull; Tradeable Rights<br>&bull; Tendered Shares Security<br>&bull; Unit Investment Trust<br>&bull; Units<br>&bull; Warrants<br>&bull; When Distributed<br>&bull; When Issued
__status__  | string | Event action status.<br>**Supported values:**<br>&bull; `C` : The issuer announced an event but later withdrew or invalidated it<br>&bull; `P` : The issuer formally cancels previously announced payment details<br>&bull; `Q` : Payment details Deleted by Issuer<br>&bull; `U` : Indicates that an existing corporate action record has been modified; The event was already published (Inserted), but one or more details have changed.<br>&bull; `I` : New corporate action record has been created and added<br>**Payment details Cancelled (P) and Deleted (Q) apply only to the payment details, not the entire event.**
__symbol\*__ `key` | string | Symbol of the security
__taxRate__  | number, null | Percent tax rate. For example, `15` represents a 15% tax rate
__toDate__  | string, null | To date. The format is `YYYY-MM-DD`.
__toFactor__  | number, null | Number of ending shares.
__unAdjustedAmount__  | number, null | Dividend rate. The amount paid before adjustments.
    
\* required

## Attribution

If you are using viaNexus Platform Data in your site or application, you must display &ldquo;**Data provided by viaNexus a product of Blue-Sky Nexus** &rdquo; (linked to https://viaNexus.com/) somewhere on that site or application.  Please see [Attribution](https://console.vianexus.com/docs/api-basics/attribution) for details.

---

- Page: https://console.vianexus.com/docs/edge/corporate-actions/advanced_dividends
- Category: [Corporate Actions](https://console.vianexus.com/docs/edge/corporate-actions)
- Provider: [edge](https://console.vianexus.com/docs/edge)

Markdown of https://console.vianexus.com/docs/edge/corporate-actions/advanced_dividends. Append `.md` to any docs URL.
