# IPO

> API Name: /CorporateAction/GetIPO

{% hint style="info" %}
**Below are some examples of how the data is presented in the API:**
{% endhint %}

{% tabs %}
{% tab title="Example 1" %}
·       "IPOId": 1264,

·       "OrganCode": "QHKTHG",

·       "ComGroupCode": "VNINDEX",

·       "IPOTypeCode": "IPO",

·       "StateOwnerOrganCode": null,

·       "AuctionDate": "2020-02-04T00:00:00",

·       "BidVolumn": 253210,

·       "AllowVolForForeigner": 243280,

·       "ParValue": 10000,

·       "BeginPrice": 10000,

·       "TotalInvestorReg": 3,

·       "CorporateInvestorReg": 0,

·       "IndividualInvestorReg": 3,

·       "TotalOrderVolumn": 155000,

·       "BidVolumnHighest": 100000,

·       "BidVolumnLowest": 5000,

·       "BidPriceHighest": 10000,

·       "BidPriceLowest": 10000,

·       "WinPriceHighest": 10000,

·       "WinPriceLowest": 10000,

·       "WinPriceAverage": 10000,

·       "TotalBuyVolumn": 155000,

·       "ForeignerBuyVolumn": 0,

·       "TotalBuyValue": 1550000000,

·       "ForeignerBuyValue": 0,

·       "CorporateInvestorWin": 0,

·       "IndividualInvestorWin": 3,

·       "PaymentStartDate": "2020-02-05T00:00:00",

·       "PaymentEndDate": "2020-02-14T00:00:00",

·       "Goal": "",

·       "AttachFileUrl": "",

·       "SourceUrl": "",

·       "Note": "",

·       "Status": 1,

·       "CreateDate": "2019-12-23T10:28:02.333",

·       "UpdateDate": "2020-02-05T08:53:24.82",

·       "GovernOrganCode": null,

·       "PublicDate": "2019-12-20T00:00:00",

·       "IPOModeOrganCode": "HOSE",

·       "IPOStatusCode": "D",

·       "IPOStartYearPlan": 2020,

·       "IPOEndYearPlan": 2020,

·       "IPOYear": 2020,

·       "IPOPlan": 0.51,

·       "DivestedToPlan": 0.6121,

·       "OwnershipAfterIPO": 0
{% endtab %}

{% tab title="Example 2" %}
·       "IPOId": 1264,

·       "OrganCode": "QHKTHG",

·       "ComGroupCode": "UPCoMIndex",

·       "IPOTypeCode": "IPO",

·       "StateOwnerOrganCode": null,

·       "AuctionDate": "2020-02-04T00:00:00",

·       "BidVolumn": 253210,

·       "AllowVolForForeigner": 243280,

·       "ParValue": 10000,

·       "BeginPrice": 10000,

·       "TotalInvestorReg": 3,

·       "CorporateInvestorReg": 0,

·       "IndividualInvestorReg": 3,

·       "TotalOrderVolumn": 155000,

·       "BidVolumnHighest": 100000,

·       "BidVolumnLowest": 5000,

·       "BidPriceHighest": 10000,

·       "BidPriceLowest": 10000,

·       "WinPriceHighest": 10000,

·       "WinPriceLowest": 10000,

·       "WinPriceAverage": 10000,

·       "TotalBuyVolumn": 155000,

·       "ForeignerBuyVolumn": 0,

·       "TotalBuyValue": 1550000000,

·       "ForeignerBuyValue": 0,

·       "CorporateInvestorWin": 0,

·       "IndividualInvestorWin": 3,

·       "PaymentStartDate": "2020-02-05T00:00:00",

·       "PaymentEndDate": "2020-02-14T00:00:00",

·       "Goal": "",

·       "AttachFileUrl": "",

·       "SourceUrl": "",

·       "Note": null,

·       "en\_Goal": null,

·       "en\_SourceUrl": null,

·       "en\_Note": null,

·       "Status": 1,

·       "CreateDate": "2019-12-23T10:28:02.333",

·       "UpdateDate": "2020-02-05T08:53:24.82",

·       "GovernOrganCode": null,

·       "PublicDate": "2019-12-20T00:00:00",

·       "IPOModeOrganCode": "HOSE",

·       "IPOStatusCode": "D",

·       "IPOStartYearPlan": 2020,

·       "IPOEndYearPlan": 2020,

·       "IPOYear": 2020,

·       "IPOPlan": 0.51,

·       "DivestedToPlan": 0.6121,

·       "OwnershipAfterIPO": 0
{% endtab %}
{% endtabs %}

<table><thead><tr><th width="203.25">Field name</th><th width="92.08984375">Data type</th><th width="73">Data length</th><th width="192">Description (VN)</th><th width="192.578125">Description (EN)</th></tr></thead><tbody><tr><td>IPOId</td><td>bigint</td><td></td><td>Khóa chính của bảng auto-generated IDENTITY(1,1)</td><td>Primary key of auto-generated IDENTITY(1,1)</td></tr><tr><td>OrganCode</td><td>nvarchar</td><td>15</td><td>Mã của tổ chức IPO StoxPlus</td><td>StoxPlus-defined code of IPO organization </td></tr><tr><td>ComGroupCode</td><td>nvarchar</td><td>15</td><td>Id của sàn thực hiện IPO lấy từ bảng stx_mst_CompanyGroup</td><td>ID of the IPO exchange taken from the stx_mst_CompanyGroup table</td></tr><tr><td>IPOTypeCode</td><td>nvarchar</td><td>5</td><td>Id Loại IPO lấy từ bảng stx_mst_IPOType. vd: IPO lần đầu, Chào bán cổ phần nhà nước, …</td><td>IPO Type ID taken from the stx_mst_IPOType table. E.g.: Initial public offering, State-owned share offering,…</td></tr><tr><td>StateOwnerOrganCode</td><td>nvarchar</td><td>15</td><td>Mã của tổ chức nhà nước thực hiện chào bán lấy từ bảng stx_cpf_Organization. StateOwnerOrganCode. Vd: Đấu giá sở hữu cổ phần của nhà nước</td><td>Code of the state organization performing the offering taken from the stx_cpf_Organization table. StateOwnerOrganCode. E.g.: Auction of state-owned shares</td></tr><tr><td>AuctionDate</td><td>datetime</td><td></td><td>Ngày đấu giá</td><td>Auction date </td></tr><tr><td>BidVolumn</td><td>decimal</td><td>(18,0)</td><td>Tổng số lượng cổ phần đưa ra đấu giá</td><td>Total number of shares offered for auction</td></tr><tr><td>AllowVolForForeigner</td><td>decimal</td><td>(18,0)</td><td>Số cổ phiếu người nước ngoài được phép mua</td><td>Number of shares foreigners are allowed to buy</td></tr><tr><td>ParValue</td><td>decimal</td><td>(18,0)</td><td>Mệnh giá cổ phiếu</td><td>Par value </td></tr><tr><td>BeginPrice</td><td>decimal</td><td>(18,0)</td><td>Giá khới điểm</td><td>Beginning price </td></tr><tr><td>TotalInvestorReg</td><td>int</td><td>4</td><td>Số nhà đầu tư đang ký tham gia</td><td>Number of investors registering to participate</td></tr><tr><td>CorporateInvestorReg</td><td>int</td><td>4</td><td>Số nhà đầu tư là tổ chức đăng ký</td><td>Number of institutional investors registering</td></tr><tr><td>IndividualInvestorReg</td><td>int</td><td>4</td><td>Số nhà đầu tư là cá nhân đăng ký</td><td>Number of individual investors registering</td></tr><tr><td>TotalOrderVolumn</td><td>decimal</td><td>(18,0)</td><td>Khối lượng cổ phiếu đăng ký mua</td><td>Volume of shares registered to buy</td></tr><tr><td>BidVolumnHighest</td><td>decimal</td><td>(18,0)</td><td>Khối lượng đặt mua lớn nhất</td><td>Highest volume of shares registered to buy</td></tr><tr><td>BidVolumnLowest</td><td>decimal</td><td>(18,0)</td><td>Khối lượng đặt mua nhỏ nhất</td><td>Lowest volume of shares registered to buy</td></tr><tr><td>BidPriceHighest</td><td>decimal</td><td>(18,0)</td><td>Giá đặt mua cao nhất</td><td>Highest bid price </td></tr><tr><td>BidPriceLowest</td><td>decimal</td><td>(18,0)</td><td>Giá đặt mua thấp nhất</td><td>Lowest bid price </td></tr><tr><td>WinPriceHighest</td><td>decimal</td><td>(18,0)</td><td>Giá trúng cao nhất</td><td>Highest winning price</td></tr><tr><td>WinPriceLowest</td><td>decimal</td><td>(18,0)</td><td>Giá trúng thấp nhất</td><td>Lowest winning price </td></tr><tr><td>WinPriceAverage</td><td>decimal</td><td>(18,10)</td><td>Giá trúng trung bình</td><td>Average wining price</td></tr><tr><td>TotalBuyVolumn</td><td>decimal</td><td>(18,0)</td><td>Tổng khối lượng bán được</td><td>Total volume sold</td></tr><tr><td>ForeignerBuyVolumn</td><td>decimal</td><td>(18,0)</td><td>Tổng khối lượng bán được cho nhà đầu tư nước ngoài</td><td>Total volume sold to foreign investors</td></tr><tr><td>TotalBuyValue</td><td>decimal</td><td>(18,0)</td><td>Tổng giá trị bán được</td><td>Total value sold </td></tr><tr><td>ForeignerBuyValue</td><td>decimal</td><td>(18,0)</td><td>Tổng giá trị bán được cho nhà đầu tư nước ngoài</td><td>Total value sold to foreign investors</td></tr><tr><td>CorporateInvestorWin</td><td>int</td><td></td><td>Số nhà đầu tư là tổ chức trúng giá</td><td>Number of winning institutional investors</td></tr><tr><td>IndividualInvestorWin</td><td>int</td><td></td><td>Số nhà đầu tư là cá nhân trúng giá</td><td>Number of winning individual investors</td></tr><tr><td>PaymentStartDate</td><td>datetime</td><td></td><td>Thời hạn bắt đầu thanh toán</td><td>Start date of payment </td></tr><tr><td>PaymentEndDate</td><td>datetime</td><td></td><td>Thời hạn kết thúc thanh toán</td><td>End date of payment </td></tr><tr><td>Goal</td><td>nvarchar</td><td>255</td><td>Mục đích chào bán</td><td>Offering purposes</td></tr><tr><td>AttachFileUrl</td><td>nvarchar</td><td>255</td><td>File attach của đợt phát hành IPO</td><td>File attach of the IPO issuance</td></tr><tr><td>SourceUrl</td><td>nvarchar</td><td>255</td><td>Nguồn thông báo IPO</td><td>IPO annoucement source</td></tr><tr><td>Note</td><td>nvarchar</td><td>255</td><td>Ghi chú cho IPO</td><td>Notes for IPO </td></tr><tr><td>GovernOrganCode</td><td>nvarchar</td><td>15</td><td>Cơ quan chủ quản</td><td>Governing body</td></tr><tr><td>PublicDate</td><td>datetime</td><td></td><td>Ngày thông báo</td><td>Public date </td></tr><tr><td>IPOModeOrganCode</td><td>nvarchar</td><td>15</td><td>Tổ chức IPO qua sàn/CTCK</td><td>Organizations involved in the IPO process through the exchange/securities company</td></tr><tr><td>IPOStatusCode</td><td>nvarchar</td><td>5</td><td>Tình trạng IPO</td><td>IPO status</td></tr><tr><td>IPOStartYearPlan</td><td>int</td><td></td><td>Năm bắt đầu kế hoạch Cổ phần hóa</td><td>Expected start year of equitization </td></tr><tr><td>IPOEndYearPlan</td><td>int</td><td></td><td>Năm kết thúc kế hoạch Cổ phần hóa</td><td>Expected end year of equitization</td></tr><tr><td>IPOYear</td><td>int</td><td></td><td>Năm Cổ phần hóa</td><td>Year of equitization</td></tr><tr><td>IPOPlan</td><td>decimal</td><td>(18,10)</td><td>% IPO plan</td><td>% of IPO planned</td></tr><tr><td>DivestedToPlan</td><td>decimal</td><td>(18,10)</td><td>% IPO thực hiện so với kế hoạch</td><td>% of IPO executed compared with planned</td></tr><tr><td>OwnershipAfterIPO</td><td>decimal</td><td>(18,10)</td><td>Tỷ lệ Nhà nước sở hữu sau IPO</td><td>State ownership percentage after IPO</td></tr><tr><td>en_Goal</td><td>nvarchar</td><td>255</td><td>Mục đích chào bán</td><td>Offering purposes</td></tr><tr><td>en_SourceUrl</td><td>nvarchar</td><td>255</td><td>Nguồn thông báo IPO</td><td>IPO announcement date </td></tr><tr><td>en_Note</td><td>nvarchar</td><td>255</td><td>Ghi chú cho IPO</td><td>Notes for IPO </td></tr><tr><td>Status</td><td>tinyint</td><td>1</td><td>Trạng thái của bản ghi. 0: record khóa; 1: record mở; 2: record đã xóa </td><td>Record status. 0: record locked; 1: record open; 2: record deleted</td></tr><tr><td>CreateDate</td><td>datetime</td><td>8</td><td>Ngày tạo record</td><td>Created date </td></tr><tr><td>UpdateDate</td><td>datetime</td><td>8</td><td>Ngày cập nhật record </td><td>Updated date</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://datafeed.fiingroup.vn/api-datafeed-en/api-corporate/event-calendar/ipo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.