Skip to main content
GET
Get corporate action

Find the Action ID

Use the UUID at the end of the uri emitted in the token contract’s onchain Announcement event. Do not use the event’s id argument: it can be numeric or include a suffix such as :pre or -1. Announcements without an addressable URI cannot be looked up through this endpoint.

Example

This example retrieves a GOOGLc cash dividend.
cURL
The response is the corporate action object itself, without a corporate_action wrapper. It includes the token, description, status, first announcement time, and onchain announcement history in chronological order.
  • CORPORATE_ACTION_STATUS_ANNOUNCED: the action is announced but has not changed the token’s multiplier.
  • CORPORATE_ACTION_STATUS_APPLIED: the multiplier update has been applied. Only then are applied_at, multiplier_before, and multiplier_after populated.
Multiplier values are already normalized from their 18-decimal fixed-point scale. Announcement block_number values are decimal strings in JSON. A malformed UUID returns HTTP 400; an unknown action or an action on a test/non-live token returns HTTP 404. Temporarily unavailable or stale action data returns HTTP 503. These errors use the JSON error format described in the API overview.

Path Parameters

id
string<uuid>
required

The corporate action UUID from the onchain announcement URI.

Response

The corporate action object, not a corporate_action wrapper.

A corporate action announced on a live tokenized equity token. Applied-only fields are omitted until the multiplier update is applied.

id
string<uuid>

The UUID in the final segment of the onchain announcement URI.

uri
string<uri>

The canonical public URI of this corporate action.

contract_address
string

The token contract address on Base.

symbol
string

The token ticker symbol.

description
string

The action description, such as Cash Dividend or Stock Split.

status
enum<string>

Whether the action is announced or applied.

Available options:
CORPORATE_ACTION_STATUS_UNSPECIFIED,
CORPORATE_ACTION_STATUS_ANNOUNCED,
CORPORATE_ACTION_STATUS_APPLIED
announced_at
string<date-time>

The time of the first onchain announcement.

applied_at
string<date-time>

The time of the multiplier-changing announcement. Omitted until applied.

multiplier_before
number<double>

The multiplier before application, normalized from its 18-decimal fixed-point value. Omitted until applied.

multiplier_after
number<double>

The multiplier after application, normalized from its 18-decimal fixed-point value. Omitted until applied.

announcements
object[]

Onchain announcements, oldest first.