Corporate Actions

Get Corporate Actions

get

https://tvda-api.platform-test.tradevest.aihttps://tvda-api.platform-pretest.tradevest.ai

/corporate-actions/

Get Corporate Actions

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Query parameters

cursorstringOptional

String value used for pagination

limitinteger · min: 1Required

Maximum number of items to return

Default: 20

startCreatedOnstring · date-timeOptional

Display corporate actions created on or after this date

endCreatedOnstring · date-timeOptional

Display corporate actions created on or before this date

Responses

200

OK

application/json

400

Bad Request

application/json

get

/corporate-actions/

HTTPcURLJavaScriptPython

GET /corporate-actions/?limit=20 HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "data": [
    {
      "corporateActionId": "123e4567-e89b-12d3-a456-426614174000",
      "corporateActionEventType": "DVCA",
      "isin": "text",
      "dates": {
        "exDate": "2026-03-04",
        "paymentDate": "2026-03-04",
        "effectiveDate": "2026-03-04",
        "recordDate": "2026-03-04",
        "responseDeadline": "2026-03-04",
        "createdOn": "2026-03-04T10:00:04.720Z",
        "modifiedOn": "2026-03-04T10:00:04.720Z"
      },
      "details": {
        "bonusRatio": 1,
        "grossAmountPerShare": 1,
        "splitRatio": 1,
        "quantitySuccessfullyTendered": 1,
        "corporateActionOptions": [
          {
            "tenderOption": "NONE",
            "isDefaultAction": true,
            "offeredPricePerShare": 10,
            "maximumQuantitySharesAccepted": 10
          }
        ]
      },
      "customer": {
        "customerId": "123e4567-e89b-12d3-a456-426614174000",
        "customerProductId": "123e4567-e89b-12d3-a456-426614174000",
        "eligibleQuantity": 1,
        "oldQuantity": 1,
        "newQuantity": 1,
        "splitRatio": 1,
        "bonusRatio": 1,
        "grossAmount": 1,
        "netAmount": 1,
        "submittedTenderedQuantity": 1,
        "submittedCorporateActionOption": "NONE",
        "currency": "EUR",
        "createdOn": "2026-03-04T10:00:04.720Z",
        "modifiedOn": "2026-03-04T10:00:04.720Z"
      }
    }
  ],
  "pagination": {
    "cursor": "text",
    "limit": 1
  }
}

Get Corporate Actions

get

https://tvda-api.platform-test.tradevest.aihttps://tvda-api.platform-pretest.tradevest.ai

/corporate-actions/customers/{customerId}

Get Corporate Actions

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

customerIdstring · uuidRequired

Unique customer identification number in UUID format

Query parameters

cursorstringOptional

String value used for pagination

limitinteger · min: 1Required

Maximum number of items to return

Default: 20

startCreatedOnstring · date-timeOptional

Display corporate actions created on or after this date

endCreatedOnstring · date-timeOptional

Display corporate actions created on or before this date

Responses

200

OK

application/json

400

Bad Request

application/json

get

/corporate-actions/customers/{customerId}

HTTPcURLJavaScriptPython

GET /corporate-actions/customers/{customerId}?limit=20 HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "data": [
    {
      "corporateActionId": "123e4567-e89b-12d3-a456-426614174000",
      "corporateActionEventType": "DVCA",
      "isin": "text",
      "dates": {
        "exDate": "2026-03-04",
        "paymentDate": "2026-03-04",
        "effectiveDate": "2026-03-04",
        "recordDate": "2026-03-04",
        "responseDeadline": "2026-03-04",
        "createdOn": "2026-03-04T10:00:04.720Z",
        "modifiedOn": "2026-03-04T10:00:04.720Z"
      },
      "details": {
        "bonusRatio": 1,
        "grossAmountPerShare": 1,
        "splitRatio": 1,
        "quantitySuccessfullyTendered": 1,
        "corporateActionOptions": [
          {
            "tenderOption": "NONE",
            "isDefaultAction": true,
            "offeredPricePerShare": 10,
            "maximumQuantitySharesAccepted": 10
          }
        ]
      },
      "customer": {
        "customerId": "123e4567-e89b-12d3-a456-426614174000",
        "customerProductId": "123e4567-e89b-12d3-a456-426614174000",
        "eligibleQuantity": 1,
        "oldQuantity": 1,
        "newQuantity": 1,
        "splitRatio": 1,
        "bonusRatio": 1,
        "grossAmount": 1,
        "netAmount": 1,
        "submittedTenderedQuantity": 1,
        "submittedCorporateActionOption": "NONE",
        "currency": "EUR",
        "createdOn": "2026-03-04T10:00:04.720Z",
        "modifiedOn": "2026-03-04T10:00:04.720Z"
      }
    }
  ],
  "pagination": {
    "cursor": "text",
    "limit": 1
  }
}