# An Asset's Corporate Actions

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

What Aurea knows of an asset — paused or not on each chain, its multiplier, its latest dividend — and the corporate actions it saw.

## Overview

- `states`: per chain, `buyPaused` and `sellPaused` (quotes, buys and sales refused while paused), `tokenPaused` (no transfer moves it), `limited`, `reason` (an Aurea code), `pausedSince`, the `multiplier` and its change, the latest `dividend`, and when it was last read (`checkedAt`).
- `actions`, newest first: `paused` and `resumed` on a chain, a new `dividend`, a new `multiplier` — each with its `detail` and `source` (`feed` or `chain`); `kind` filters them. The same news is sent to your webhooks that name them, as `tokenized_asset.paused`, `tokenized_asset.resumed` and `tokenized_asset.corporate_action` ([Webhooks & Events](https://docs.aureahub.com/docs/guide-events.md)). While an asset is paused on a chain, its quotes and their execution there are refused with `409` `TOKENIZED_ASSETS_ASSET_PAUSED`.
- Read every few minutes for the assets a tenant offers: `states` and `actions` stay empty until the asset's first reading. A state is believed only while it is recent: an old one refuses nothing.
- For the assets traded with quotes; an asset the issuer issues and redeems directly answers `409` `TOKENIZED_ASSETS_NOT_SUPPORTED_FOR_ASSET` — read its [calendar](https://docs.aureahub.com/docs/tok-asset-ca-calendar.md). 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.`). |

## Endpoint

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

Authentication: bearer token required.

An asset's states and the corporate actions seen.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | yes | The token's symbol, as its contract names it (case matters). |

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | string | no | `true`: the test environment; `false` (the default): production. |
| `kind` | string | no | Only the actions of this kind. One of `paused`, `resumed`, `dividend`, `multiplier`. |
| `limit` | integer | no | At least 1, at most 100. Default `25`. |
| `offset` | integer | no | At least 0, at most 100000. Default `0`. |

**Responses**

`200` Nothing Recorded

```json
{
  "isTestnet": false,
  "symbol": "AAPLon",
  "states": [],
  "actions": [],
  "total": 0,
  "limit": 25,
  "offset": 0
}
```

`200` Recorded

```json
{
  "isTestnet": false,
  "symbol": "AAPLon",
  "states": [
    {
      "chainId": 1,
      "buyPaused": false,
      "sellPaused": false,
      "tokenPaused": false,
      "limited": null,
      "reason": null,
      "pausedSince": null,
      "multiplier": "1.002931",
      "corporateActionPause": false,
      "multiplierChangedAt": "2026-08-15T00:00:00.000Z",
      "dividend": {
        "amount": "0.26",
        "paymentDate": "2026-08-14",
        "yield": "0.0041",
        "frequency": "quarterly"
      },
      "checkedAt": "2026-10-07T15:00:00.000Z"
    }
  ],
  "actions": [
    {
      "actionId": "e7b3c1d2-4a5f-4e86-9b07-3c2d1e0f9a84",
      "symbol": "AAPLon",
      "chainId": null,
      "kind": "multiplier",
      "detail": {
        "previous": "1.001894",
        "current": "1.002931"
      },
      "source": "feed",
      "effectiveAt": "2026-08-15T00:00:00.000Z",
      "observedAt": "2026-08-15T00:04:12.000Z"
    }
  ],
  "total": 1,
  "limit": 25,
  "offset": 0
}
```

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

---

Web version: https://docs.aureahub.com/#tok-asset-corporate-actions