IPO Allotment Status API - Official Basis of Allotment PDF
Provides official registrar documentation links proving allotment calculations, retail quota success ratios, and applicant draw tables by year (e.g. 2026) and board type (mainboard, sme, all).
Endpoint Overview & Architecture
The Basis of Allotment (BoA) is the definitive statutory document published jointly by the lead merchant bankers, designated stock exchange, and share transfer registrar (such as Link Intime, KFintech, Bigshare Services, Skyline, or Maashitla). It provides certified mathematical proof of how shares were allocated across valid bids.
Unlike third-party scraper approximations, this endpoint gives developers direct access to certified Basis of Allotment records and hosted PDF document links organized by year and exchange board segment (mainboard, sme, or all).
Each record discloses the category-wise oversubscription multiple, number of valid applications received, number of allottees selected via randomized lottery draw, and exact share allotment ratios. This data is essential for historical research, post-issue analytics, and automated allotment verification tools.
Request Authentication Headers
| Header Name | Type | Required | Description |
|---|---|---|---|
| ApiKey | string | Required | Your secret API access key provided upon subscription registration. |
| ApiSecret | string | Required | Your secret API client secret used to sign and authenticate requests. |
Request Parameters
| Parameter | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| year | path | integer | Required | 2026 | Calendar year. |
| ipoType | path | string | Required | all | Exchange type: "all", "mainboard", or "sme". |
| pageNumber | query | integer | Optional | 1 | Page index. |
| perPageRow | query | integer | Optional | 20 | Records per page. |
Code Examples
curl -X GET "https://api.ipoapipro.in/api/allotment/basis-records/2026/all?pageNumber=1&perPageRow=20" \ -H "ApiKey: YOUR_API_KEY" \ -H "ApiSecret: YOUR_API_SECRET"
Sample JSON Response
{
"isSuccess": true,
"message": "Successfully.",
"totalRowCount": 24,
"data": [
{
"ipoId": 67,
"companyName": "Clean Max Enviro Energy Solutions Ltd",
"type": "MAINBOARD",
"basicOfAllotment": "https://api.ipoapipro.in/upload/ipodata/boa/clean-max-basis-of-allotment.pdf"
}
]
}Response Attributes Schema
| Attribute | Type | Description |
|---|---|---|
| data[].basicOfAllotment | string (URL) | Direct PDF or document download URL for the certified registrar basis of allotment document. |
HTTP Status & Error Codes
| HTTP Code | Title | Condition & Resolution |
|---|---|---|
| 400 | Bad Request | Missing mandatory query parameters, invalid types, or unsupported filter combinations. |
| 401 | Unauthorized | The request lacked valid authentication credentials (ApiKey or ApiSecret). |
| 403 | Forbidden | The subscription plan has expired or this specific endpoint is not included in the plan. |
| 429 | Too Many Requests | Rate limit exceeded. Standard tier permits 60 req/min, Professional tier permits 300 req/min. |
| 500 | Internal Server Error | Downstream exchange connection glitch or upstream registrar network timeout. |
Rate Limits & Edge Caching SLA
Default Rate Limit: 60 requests/minute (Standard) | 300 requests/minute (Pro). Requests are served through Cloudflare edge points of presence across Mumbai, Delhi, Bengaluru, and Chennai with sub-15ms cached latency.
Related IPO API Endpoints
Retrieve paginated listings of Mainboard IPOs with price bands, issue size, timeline, and exchange data.
Deep-dive company profiles, multi-year financial tables, schedule milestones, and registrar contacts.
Master subscription feed combining share bids, application counts, lottery winner odds (PeopleBase), and narrative AI summaries.