# Right to Purchase

Corporate action right to purchase. Includes international symbols. History available since 2007.

- **Category:** Corporate Actions
- **Type:** historical
- **Workspace:** EDGE
- **Dataset Id:** ADVANCED_RIGHT_TO_PURCHASE
- **Region:** US
- **Records:** 53,379
- **Newest Record:** 2027-01-25
- **Oldest Record:** 2000-04-05
- **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_RIGHT_TO_PURCHASE`
- `https://api.blueskyapi.com/v1/data/EDGE/ADVANCED_RIGHT_TO_PURCHASE/:symbol`
- `https://api.blueskyapi.com/v1/data/EDGE/ADVANCED_RIGHT_TO_PURCHASE/:symbol/::refid`
- `https://api.blueskyapi.com/v1/data/edge/advanced_right_to_purchase?range=last-week`
- `https://api.blueskyapi.com/v1/data/edge/advanced_right_to_purchase?range=next-month&calendar=true`
- `https://api.blueskyapi.com/v1/data/edge/advanced_right_to_purchase/aapl?last=4`
- `https://api.blueskyapi.com/v1/data/edge/advanced_right_to_purchase/AAPL,MSFT,VZ`

Example API request: `https://api.blueskyapi.com/v1/data/EDGE/ADVANCED_RIGHT_TO_PURCHASE?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
-------------|--------|-------------
__countryCode__  | string, null | Country code for the symbol, using [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)
__created__  | string, null | Date the 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`
__description__  | string, null | Security description
__exDate__ `date` | string, null | Date that determines which shareholders is entitled to receive the issue. The format is `YYYY-MM-DD`.
__figi__  | string, null | OpenFIGI ID for the symbol
__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`
__isOverSubscription__  | boolean, null | true if subscription is over, otherwise false
__issuePrice__  | number, null | Issue price
__lastUpdated__  | string, null | Date the record was last changed. The format is `YYYY-MM-DD`.
__notes__  | string, null | Long description
__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`.
__recordDate__  | string, null | Date the company examines its current list of shareholders to determine who receives the issue. Only shareholders in the company books as of this date are entitled to receive the issue. The format is `YYYY-MM-DD`.
__refid__ `subkey` | string | Unique ID representing the record
__resultSecurityType__  | 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
__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, null | 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.**
__subscriptionEnd__  | string, null | Formatted as `YYYY-MM-DD`
__subscriptionStart__  | string, null | Formatted as `YYYY-MM-DD`
__symbol\*__ `key` | string | Symbol of the security
    
\* 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_right_to_purchase
- 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_right_to_purchase. Append `.md` to any docs URL.
