List the corporate actions on a token
curl --request GET \
--url https://partners-api.sandbox.securitize.io/corporate-actions/v1/tokens/{tokenId}/corporate-actions \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://partners-api.sandbox.securitize.io/corporate-actions/v1/tokens/{tokenId}/corporate-actions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://partners-api.sandbox.securitize.io/corporate-actions/v1/tokens/{tokenId}/corporate-actions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"sourceCaId": "ca_01K7Q3ZVB8M2N4P6R8T0V2X4Z6",
"version": 2,
"assetId": "c0a8e2f4-1b3d-4e5f-8a9b-0c1d2e3f4a5b",
"caType": "CASH_DIVIDEND",
"caCategory": "MANDATORY",
"isoEventCode": "DVCA",
"status": "CONFIRMED",
"dataCompleteness": "COMPLETE",
"dates": {
"announcementDate": "2026-10-20",
"exDate": "2026-11-10",
"recordDate": "2026-11-10",
"snapshotTime": "2026-11-10T01:00:00.000Z",
"effectiveTime": null,
"payDate": "2026-11-13",
"electionStart": null,
"responseDeadline": null,
"marketExpiration": null,
"votingCutoff": null,
"meetingDate": null
},
"terms": {
"grossAmountPerShare": "0.26",
"currency": "USD",
"paymentAsset": {
"chainId": "eip155:196",
"tokenAddress": "0x74b7f16337b8972027f6196a17a631ac6de26d22",
"symbol": "USDC"
},
"withholdingApplies": true,
"frankingOrTaxNotes": null
},
"options": [],
"venueActions": {
"tradingStop": {
"required": false
},
"poolMode": "NORMAL",
"displayToHolders": true
},
"relatedCaIds": [],
"supersedesCaId": null,
"supersededByCaId": null,
"description": "Quarterly cash dividend of USD 0.26 per share",
"documents": [
{
"title": "Press release",
"url": "https://investor.example.invalid/dividend-2026-q4.pdf"
}
],
"settlement": null
}
]
}{
"error": "Bad Request",
"message": [
"each value in status must be one of the following values: OPEN, CLOSED, UNAVAILABLE"
],
"statusCode": 400
}{
"error": "UNAUTHORIZED",
"message": "Missing or unknown partner identity",
"statusCode": 401
}{
"error": "TOKEN_NOT_FOUND",
"message": "No token with id '7f3b2c10-5d4e-4a6b-9c8d-1e2f3a4b5c6d'",
"statusCode": 404
}Tokens
List the corporate actions on a token
Every corporate action on the asset of the token, latest version of each, newest first. A corporate action is registered once per asset and applies to every chain, so the objects carry no tokenId. from and to keep a corporate action when any of its dates falls in the range; one with no dates never matches a range.
GET
/
tokens
/
{tokenId}
/
corporate-actions
List the corporate actions on a token
curl --request GET \
--url https://partners-api.sandbox.securitize.io/corporate-actions/v1/tokens/{tokenId}/corporate-actions \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://partners-api.sandbox.securitize.io/corporate-actions/v1/tokens/{tokenId}/corporate-actions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://partners-api.sandbox.securitize.io/corporate-actions/v1/tokens/{tokenId}/corporate-actions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"sourceCaId": "ca_01K7Q3ZVB8M2N4P6R8T0V2X4Z6",
"version": 2,
"assetId": "c0a8e2f4-1b3d-4e5f-8a9b-0c1d2e3f4a5b",
"caType": "CASH_DIVIDEND",
"caCategory": "MANDATORY",
"isoEventCode": "DVCA",
"status": "CONFIRMED",
"dataCompleteness": "COMPLETE",
"dates": {
"announcementDate": "2026-10-20",
"exDate": "2026-11-10",
"recordDate": "2026-11-10",
"snapshotTime": "2026-11-10T01:00:00.000Z",
"effectiveTime": null,
"payDate": "2026-11-13",
"electionStart": null,
"responseDeadline": null,
"marketExpiration": null,
"votingCutoff": null,
"meetingDate": null
},
"terms": {
"grossAmountPerShare": "0.26",
"currency": "USD",
"paymentAsset": {
"chainId": "eip155:196",
"tokenAddress": "0x74b7f16337b8972027f6196a17a631ac6de26d22",
"symbol": "USDC"
},
"withholdingApplies": true,
"frankingOrTaxNotes": null
},
"options": [],
"venueActions": {
"tradingStop": {
"required": false
},
"poolMode": "NORMAL",
"displayToHolders": true
},
"relatedCaIds": [],
"supersedesCaId": null,
"supersededByCaId": null,
"description": "Quarterly cash dividend of USD 0.26 per share",
"documents": [
{
"title": "Press release",
"url": "https://investor.example.invalid/dividend-2026-q4.pdf"
}
],
"settlement": null
}
]
}{
"error": "Bad Request",
"message": [
"each value in status must be one of the following values: OPEN, CLOSED, UNAVAILABLE"
],
"statusCode": 400
}{
"error": "UNAUTHORIZED",
"message": "Missing or unknown partner identity",
"statusCode": 401
}{
"error": "TOKEN_NOT_FOUND",
"message": "No token with id '7f3b2c10-5d4e-4a6b-9c8d-1e2f3a4b5c6d'",
"statusCode": 404
}