# An Asset's Corporate-Action Calendar

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

The corporate actions an asset's issuer announced, upcoming and past.

## Overview

- Newest announced first. Each action: its `kind` (`cash_dividend`, `stock_dividend`, `cash_and_stock_dividend`, `forward_split`, `reverse_split`, `unit_split`, `spin_off`, `cash_merger`, `stock_merger`, `stock_and_cash_merger`, `redemption`, `name_change`, `worthless_removal`, `rights_distribution`, `reorganization` or `unknown`), `status` (`initial`, `corrected`, `cancelled`, `scheduled`), when it takes effect and was announced, how it moves the multiplier, the cash it reinvests (gross, net, withholding tax rate), the units it converts and a redemption's price.
- `closesProduct`: the action ends the product — a redemption, a merger or a worthless removal; `closure` is that action when one is announced. Kept five minutes; at most a hundred of each list.
- For the assets whose states and actions Aurea records itself, see [Corporate Actions](https://docs.aureahub.com/docs/tok-asset-corporate-actions.md). For the assets the issuer issues and redeems directly (those with `details` in [Get an Asset](https://docs.aureahub.com/docs/tok-asset-get.md)); any other asset answers `409` `TOKENIZED_ASSETS_NOT_SUPPORTED_FOR_ASSET`.
- User token and the tenant signature ([Calling the Routes](https://docs.aureahub.com/docs/guide-tokenized-assets.md)); every tenant role may call it.

## Errors

Besides [the answers every tokenized assets route can give](https://docs.aureahub.com/docs/guide-tokenized-assets.md) (no valid token or signature, the module not set up or not switched on, a field that does not fit):

| Status | details.code | When |
| --- | --- | --- |
| 404 | TOKENIZED_ASSETS_ASSET_NOT_OFFERED | Your tenant does not offer this symbol in this environment (`This tenant does not offer this asset.`). |
| 409 | TOKENIZED_ASSETS_NOT_SUPPORTED_FOR_ASSET | An asset without this data (`This is not available for this asset.`). |
| 503 | TOKENIZED_ASSETS_PROVIDER_… | The issuer's data could not be read ([Provider Errors](https://docs.aureahub.com/docs/guide-tokenized-assets.md)); in the test environment, `TOKENIZED_ASSETS_PROVIDER_UNAVAILABLE` today. |

## Endpoint

### `GET /v1/tokenized-assets/assets/{symbol}/corporate-actions/calendar`

Authentication: bearer token required.

The corporate actions the issuer announced, upcoming and past.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | yes | The token's symbol, as its contract names it (case matters). Pattern `^[A-Za-z0-9.-]{1,32}$`. |

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | string | no | `true`: the test environment; `false` (the default): production. |

**Responses**

`200` OK

```json
{
  "isTestnet": false,
  "symbol": "AAPLx",
  "upcoming": [
    {
      "id": "ca-31877",
      "version": 1,
      "kind": "cash_dividend",
      "status": "scheduled",
      "effectiveAt": "2026-11-14T00:00:00.000Z",
      "announcedAt": "2026-10-30T20:00:00.000Z",
      "multiplierBefore": "1.004213",
      "multiplierAfter": "1.005102",
      "grossCashflowUsd": "0.26",
      "netCashflowUsd": "0.221",
      "withholdingTaxRate": "0.15",
      "fromUnits": null,
      "toUnits": null,
      "redemptionPriceUsd": null,
      "closesProduct": false
    }
  ],
  "past": [],
  "closure": null
}
```

[Contact us for details](https://www.aureahub.com/contact).

---

Web version: https://docs.aureahub.com/#tok-asset-ca-calendar