data-corporateActions
Retrieve corporate action events (cash dividends, stock dividends, rights issues, etc.) by symbol and date range. Events that have an ex-rights date are filtered by that date; newly announced events without an ex-rights date yet are filtered by their issue date or announcement date, in which case exrightDate and ratio may be empty strings. Results are sorted by ex-rights date in descending order. The required scope is data:corporateActions:get.
Authorization
Bearer Enter the JWT token in the format Bearer <token>.
In: header
Header Parameters
The content format of the request body, use "application/json".
Information about the client sending the request.
The desired response language. If this header is absent, the system defaults to en.
Query Parameters
The securities symbol to query (letters and digits only, up to 20 characters). If not provided, events for all symbols are returned.
The start date in `YYYY/MM/DD` format. Must be less than or equal to `to`.
The end date in `YYYY/MM/DD` format. The range between `from` and `to` must not exceed 5 days.
The language of the returned data (for example `eventTitle`). Possible values are `vn` or `en`. If not provided, the system uses the default value of `vn`.
The page index for paginated results, starting from 1. If not provided, the system uses the default value of 1.
The number of records per page for paginated results. Possible values are `10`, `20`, `50` or `100`. If not provided, the system uses the default value of 10.
Response Headers
The request limit for the period.
The number of requests remaining in the current period.
The time at which the request limit resets.
Response Body
application/json
application/json
curl -X GET "https://api.ssi.com.vn/api/v3/data/corporateActions?from=2026%2F10%2F08&to=2026%2F10%2F12" \ -H "Content-Type: application/json"Success
{
"pageSize": 0,
"pageIndex": 0,
"pagesCount": 0,
"itemsCount": 0,
"data": [
{
"symbol": "GDA",
"eventTitle": "string",
"exrightDate": "2026/10/12",
"recordDate": "2026/10/13",
"issueDate": "2026/10/30",
"exchange": "HOSE",
"ratio": "0.9388"
}
]
}No data matches the query conditions (the response has no body).
Invalid request.
{
"code": "400",
"msg": "Invalid request"
}