Lịch trả cổ tức và chia tách cổ phiếu

API trả về danh sách các sự kiện liên quan đến cổ tức và chia tách/phát hành cổ phiếu của doanh nghiệp theo từng mã, hỗ trợ phân trang để xem lịch sử theo thời gian.

HTTP request

• URL: /api/company/v1/partner/separate-share
• Method: POST
• Content Type: application/json
• Response Type: application/json

Tham số header

Header	Mô tả	Kiểu dữ liệu	Bắt buộc
X-Api-Key	Khóa duy nhất.	string	có

Yêu Cầu (Request)

Request Mẫu

{
  "tickers": [
    "VNM"
  ],
  "page": 0,
  "size": 9
}

Chi Tiết Tham Số Request Body

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
tickers	array of string	Danh sách mã cổ phiếu cần truy vấn (ví dụ: ['VNM']).
page	number	Trang dữ liệu cần lấy.
size	number	Số bản ghi của một trang.

Phản Hồi (Response)

Response Mẫu

{
  "status": 200,
  "message": "Success",
  "total": 39,
  "data": [
    {
      "id": "639a1d04a7be7d715e1f4041",
      "ticker": "VNM",
      "content": "Trả cổ tức  đợt 2/2022 bằng tiền, 1,400 đồng/CP",
      "date": "22/12/2022"
    },
    {
      "id": "62d96a52283ed49bd51ba9e3",
      "ticker": "VNM",
      "content": "Trả cổ tức  đợt 1/2022 bằng tiền, 1,500 đồng/CP",
      "date": "06/07/2022"
    },
    {
      "id": "626039734886f4405b1c907b",
      "ticker": "VNM",
      "content": "Cổ tức bằng Tiền, tỷ lệ 14%",
      "date": "10/01/2022"
    },
    {
      "id": "626039744886f4405b1c907c",
      "ticker": "VNM",
      "content": "Cổ tức bằng Tiền, tỷ lệ 15%",
      "date": "07/09/2021"
    },
    {
      "id": "626039744886f4405b1c907d",
      "ticker": "VNM",
      "content": "Cổ tức bằng Tiền, tỷ lệ 11%",
      "date": "07/06/2021"
    },
    {
      "id": "626039754886f4405b1c907e",
      "ticker": "VNM",
      "content": "Cổ tức bằng Tiền, tỷ lệ 10%",
      "date": "05/01/2021"
    },
    {
      "id": "626039754886f4405b1c907f",
      "ticker": "VNM",
      "content": "Cổ tức bằng Tiền, tỷ lệ 20%<br>Thưởng bằng Cổ phiếu, tỷ lệ 5:1",
      "date": "29/09/2020"
    },
    {
      "id": "626039764886f4405b1c9080",
      "ticker": "VNM",
      "content": "Cổ tức bằng Tiền, tỷ lệ 15%",
      "date": "29/06/2020"
    },
    {
      "id": "626039764886f4405b1c9081",
      "ticker": "VNM",
      "content": "Cổ tức bằng Tiền, tỷ lệ 10%",
      "date": "26/12/2019"
    }
  ]
}

Chi Tiết Tham Số Response

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
status	number	Mã trạng thái HTTP.
message	string	Thông báo kết quả xử lý.
total	number	Tổng số bản ghi.
data	array (Xem chi tiết)	Danh sách sự kiện cổ tức/chia tách theo mã cổ phiếu.

Cấu trúc thuộc tính data

Quay lại

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
id	string	ID
ticker	string	Mã cổ phiếu.
content	string	Nội dung sự kiện (ví dụ: Trả cổ tức bằng tiền, thưởng cổ phiếu, tỷ lệ…).
date	string	Ngày công bố/hiệu lực của sự kiện (dd/MM/yyyy).