# 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>
