Skip to main content
GET
/
assets
/
{asset_id}
/
corporate-actions
Get corporate actions (dividends, splits, etc.) for an asset
curl --request GET \
  --url https://api.bluum.finance/v1/assets/{asset_id}/corporate-actions \
  --header 'Authorization: Basic <encoded-value>'
{
  "corporate_actions": [
    {
      "id": "ca_123456",
      "corporate_action_type": "dividend",
      "ex_date": "2024-02-15",
      "payment_date": "2024-02-20",
      "record_date": "2024-02-16",
      "cash": "0.24",
      "old_shares": "1",
      "new_shares": "4",
      "symbol": "AAPL"
    }
  ],
  "symbol": "AAPL",
  "next_page_token": "<string>"
}

Authorizations

​
Authorization
string
header
required

HTTP Basic Authentication using the API Key as username and API Secret as password.

Path Parameters

​
asset_id
string<uuid>
required
Example:

"6c5b2403-24a9-4b55-a3dd-5cb1e4b50da6"

Query Parameters

​
types
enum<string>

Comma-separated list of corporate action types to filter

Available options:
dividend,
split,
merger,
spinoff,
rights_offering
​
start
string<date-time>

Start time for the data range (ISO 8601)

​
end
string<date-time>

End time for the data range (ISO 8601)

​
limit
integer
default:100

Maximum number of corporate actions to return

Required range: 1 <= x <= 1000
​
page_token
string

Token for pagination

Response

Corporate actions data

​
corporate_actions
object[]
​
symbol
string
Example:

"AAPL"

​
next_page_token
string | null

Token for pagination